
‘ili/i uti 

t~i i i 


U.S.$9.95 Vol.7No.8 
Canada $10.95 


a 74470 1E531 


THE MAGAZINE FOR AD 

fi m 

V A N C E D SOFTWARE’ 

V| 

Client/Server 

m 

% V1 

Migration 

A 11 

I What's In a 

1^ V 

Bitmap? 


The Dos and 

H 

Don'ts of Drag 

^ i 

and Drop 


j Accessing 


Multimedia 1 


Data from i 

■^P •! 

OpenDoc 1 

Hull 


A Miller Freeman Publication 

i 



































The verdict is: One s a pleasure, 
two are useful, and ones a pain. 

Scores run from 7.2 
to 2.7, from worthy 
to worthless. 
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Dr.Dobb’s There's a 

saying that 
good design is invisible. .4s Ward 
Cunningham puts it. ’‘Good class 
libraries whisper the design in your 
ear." This is the case with zApp, 
which straightforwardly provides 
all the usual classes you ‘d expect 
in building event-drawn GUI 
programs: a main application class . 
a small hierarchy of event handling 
classes , classes for graphic display 
window-containing classes, and the 
usual GUI widgets (push buttons, 
check box , list box. and so onf 
There are no radical concepts or 
unpleasant surprises, greatly easing 
any learning curve associated with 
a brand-new A FI 

Ray Valdes - October, tm 


Program now 


The doc¬ 
umentation 
provided with zApp is little short 
of superb, zApp 2. 0 is a professional 
product which turns platform- 
independence into a practical 
proposition by its efficient, versatile 
and function-rich implementation , 


When presenting 
zApp with their 
Editor's Choice Award\ Willie 
Watts explained why he “plumped 
forzAppOf all the C+ + encap¬ 
sulations of Windows in ail the bars 
in the world, we both felt this was 
the best attempt we had seen. and 
was something of a landmark in the 
use of this important language, 

JINJRlAlOf 

OBJECF-OWENTH) 

The class design is the most impor¬ 
tant and most subjective aspect o f 
a class library, and / think zApp's 
is superb. zApp encapsulates the 
entire underlying native A FI. 

In other words, if you want a 
Windows dialog, you get a Windows 
dialogue, not something that looks 
like one. 


El, 

hm 


y /fv long as you write 
| your applications 
■I using zApp objects, 
you can create 
programs for one compiler or 
environment and recompile them 
with another compiler for a different 
environment without any changes... 
zApps object hierarchy remains the 
most comprehensive l ve yet seen 
in an application framework. 

tkpPC UAGAStME “ the 21 W2 
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Mark 

Briltingham, 
a user-interface specialist with 
AT&T Belt Labs in Middletown, NJ, 
chose zApp over other frameworks 
" You can see it V built by someone 
who builds applications, " 

ktprintitd fhrm Pi b'EEk " Ju/v j 1 If, i WJ 
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Development 
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++REPORT 


indows 

nu-j- Tec * Award f or 

ISWA C/C++, and 

Application Frameworks goes to 
In mark Development Corp s zApp 
¥.2.0 , zApp is simply the best 
designed applied tion framework 
on the market. Its well-conceived 
classes make Windows programming 
an easier and more manageable 
process-and even fun. If C++ is 
your language of choice, then you 
should he using zApp. Period, 

[p-lJJV' f For general- 
purpose 

applications that aren't limited to 
text, basic graphics, and dialog 
boxes, however, / suggest evaluating 
zApp first. Features like advanced 
graphics, printing support, DDE 
compatibility with third-party 
resource tools, and the ability to 
incorporate custom controls can 
he hard to live without... 

Rqmmatfiam “CQifrUTE*SHOPPER M StfS tWi 
CefWipUO i W„T /tty-Dava. EuNufiHij; Cvmpum 


Marketing people say things like 
"zApp is great. It contains over 
200 classes. " That looks good in 
a slick and glossy brochure, but it 
leaves the fundamental question 
unanswered : Are they good classes? 
They are. zApp s classes are well- 
implemented and easy to use. The 
library co vers the full breadth of 
contemporary functionality and 
offers portability across most major 
operating systems. 


With the 
addition 
of a visual 
screen builder, the final barrier to 
zApp productivity has fallen. For 
quick, form-based applications, 
zApp Factory makes C++ produc¬ 
tive enough to be competitive with 
the interpreted languages. For more 
serious applications, the zApp 
framework is a superior application 
framework l would use it even if 
l were just programming for 
Windows t hut the fact that it 
compiles for Windows, Bln/NT, 
OS/2. UNIX ; and X/Motif is 
a nice little bonus. 





What I've 
noticed 
about the 
company behind the product is that 
Inmark 's customer technical support 
is outstanding (usually a returned 
call within four hours), their BBS 
is full of great information, and 
their attention to quality 
is stellar, / wish all 
software tool providers 
did as well . 


Award winning developers use Award winning tools. 


With the award winning zApp* Developer's Suite, you can quickly build state-of-the-art C++ applications 
that run across fourteen of today’s most popular operating systems. The zApp Developer's Suite contains 
the latest in drag-and-drop design, prototyping and testing, code generation, and powerful GUI objects. 
Best of all this powerful technology sits on top of zApp, the industry leading application framework in 
use by tens of thousands of developers worldw ide. For a free demo coll: 1 -800*346*6275 




INMARK 


Ititturk Development Ctu-purattati 2065 l.jndinys Drive, Mountain View, CA 94043 ($00) 146-6275, (4)5) 691,9000 Fax: (415) 691,9099 
In Ute V.K. and Scandinavia, cull PTS/Software Plus m ^44 (0) 92« 579900. In France, call PTS/Soflware Plus it (05) 90S 194, In Germany, call ESM Softwaren l)7702-9I56-fl, 

In Italy, cull Silkon VhJIcj On-I Inc at (049| H719820, In Australia, call Micro Ws\ a! (02) 58Q-13J2, BUS: 415-691-99911 * Interned mfotS mmaA cctn * CompuServe: GO iNMARK 





















It Took Teamwork to Reach 

the Moon 



With the all newVisPro 3.0, your OS/2 programming 
team can work together, at a price that's down-to-earth 


For years, the VisPro family of visual programming 
products has made OS/2 programming easy with 
Workplace Shell-enabled drag and drop 
programming. Our responsive and FREE technical 
support never leaves customers drifting in space. Now, 
whether you're part of a large OS/2 development crew 
or flying solo, the all-new VisPro/REXX Gold, VisPro/C 
and VisPro/C++ will guarantee you a smooth 
client/server programming ride. 

Team Development 

Take a seat at mission control with VisPro 30 s Team 
Administrator Compare change levels and project 
versions with ease, rollback changes, and monitor 
development progress. Team development also gives 
you automatic change logging, form shadowing, form 
locking and read-only browsing; all seamlessly 
integrated, so you don't need to be a rocket scientist. 

Support for More Databases 

With VisPro’s entity/relationship Database Designer, 
you can now design and reverse-engineer IBM DB2, 


Watcom SQL, or any ODBC-enabled database. 
Generating DDL is fast and easy. VisPro/C and 
VisPro/C++ now generate native embedded SQL for 
Sybase, Oracle, IBM DB2 and Watcom SQL. VisPro 3 0 
makes database programming easier than ever. With a 
simple drag and drop, you can instantly generate GUI 
panels for adding, changing, deleting and searching 
for rows in a table. The all new r join and drill-down 
support makes creating complex queries a breeze. 

Other Essential Gear 

The VisPro/Paint image editor is included free to 
allow you to edit BMP, TIF, GIF, and many other image 
formats. The VisPro IPF Help File editor makes it 
easier to create online help for your applications, 

Bath VisPro/C and VisPro/C++ now support the IBM 
VisualAge C++ and MetaWare High C compilers, In 
addition, VisPro/C also supports the Borland and 
W'atcom OS/2 compilers. VisPro/REXX includes 
hundreds of new APIs, Dynamic Data Exchange 
(DDE) support and an improved multi-threaded 


REXX debugger with support for conditional break 


points and animation. 

The Complete VisPro Family 

VisPro/REXX Gold 3.0..$299 

VisPro/REXX Bronze,... $ 59 

VisPro/REXX Data Entry Object Pack .... $ 89 

VisPro/C or VisPro/C++ 3.0.$299 

VisPro/Reports.. $199 

VisPro Development Suite 3.0..$499 


Whether you've already 
discovered the VisPro family 
of visual programming 
products of you're just 
getting to know us, VisPro 
3.0 will take you where you 
want to go. 

HoekWare 
PO. Box 33 
Cary. NC 27512-0336 
919-380-0616 
9 J 9-380-0757 FAX 
Go HoekWare on CompuServe 
hockwarc@vnet.net on Internet 
httpJ/www.lxHikware.com/hockware 





HockWarc. VlsPro/C, VlsPro/€++, VisPro/REXX and VisPro/Reports are trademarks of HoekWare Incorporated. .\H other company, product and brand names are (rademarks and/or registered iradcmarks of iheir 

respective holders and are mentioned for reference purposes only. C 1995 HoekWare Incorporated All riphls reserved. 
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Best Sellers from 


Visual SlickEdit 
for OS/2— 

the Intelligent 
programmer’s editor 

by MicroEdge, tnc> 

Tlti^ high-powered programmer’s 
editor is completely customizable 
with the speed to ignite your pro¬ 
ductivity. Save time using BRIEF, 

Emacs, or VI emulations. Take 
off with Visual SlickEdiTs GUI interface, built-in dialog editor, 
and C-style macro language. Features include: SmartPaste "'; 
compiler error processing: syntax color-coding; expansion and 
indenting; and an on- line manual. 30 day risk-free trial I 
Discoun l Price: *219* * Offer ends Decern her 3l,1995, 

Paradise No. MEVSE3100-EI 



HyperACCESS 
for OS/2 

by HUgraeve, Inc, 
HyperACCESS for OS/2 is the 
complete, retail version of 
HyperACCESS Lite, the easy-to- 
use terminal program bundled with 
OS/2 Warp. HyperACCESS for 
OS/2 comes packed with exciting 
new graphical powers, a resource 
library listing thousands of ready- 
lo culi online systems, and instant-benefit utilities that let even 
novice users reap immediate rewards from going online. 

Discount Price; *89 
Paradise No, HGHAS3 KMTEI 




CATALOG 


KopyKat 
Remote Control 

by HUgraeve, Inc , 

Anything you can run on a PC with 
OS/2 you can now do remotely via 
LAN, Modems, or Serial Cable. You 
can run: the remote computer's entire 
OS/2 desktop; presentation manager 
programs—both 16- and 32-bit; 
command sessions or text mode...win¬ 
dowed or full screen; Microsoft 
Windows "seamless'’ or full screen; and DOS sessions or pro- 
gnims, windowed or full screen. Runs on Novell & IBM LANs. 

Discount Price: *119 
Paradise No. HGKKO3I00-EI 


PRODUCT OF THE MONTH 



Paradise No, IB3GH1666-EI 
Competitive Upgrade 
Paradise No. IB30HI77&-E1 


Discount Price; *289 


£ 




c-tree Plus® 

by FairCom Corporation 

DOS * WINDOWS * NT - UNIX * 

OS/2 - SUN * RS60CH1 * HP9QG0 * 

MAC * QNX * BANYAN * SCO 
This well known, highly portable data 
management package has become 
established as the tool of choice for 
commercial development- Offering 
unprecedented data control, choose 
from direct low level access, ISAM 
level, or SQL access with the FairCom Server. Single-User, 
Multi-User, or optional Client/Server, ANSI Standard. Full 
Source. No Royalties, 

Discount Price: *769 
Paradise No, FACT+3100-EI 


FAIRCOM* 

since IS79 



DataTable 
for OS/2 

by ProtoView 
Development Corp. 

DataTable is a sophisticated 
spreadsheet control. Through 
a robust message-based API 
and numerous notification codes, developers can control every 
aspect of their application. Features include; virtual memory 
management; column sorting: column locking; check boxes and 
combo boxes; and colors and fonts may be set on a cell, row, 
column or table basis. New for OS/2, vertical window splitting. 


Discount Price; *476 
Paradise No, PDDT03100-EI 


Paradise No. Discount Price 

Borland C++ 2.0 for OS/2 
BOCOTS88B-EI .....*.....,....,..*339 
PREDJTOR/2 

CWPD23IQQ-EL.....*149 

GammaTech Utilities 
STGT03100-EI ...._............"99 

IBM Smalltalk 2.0 

IBM14H0270-EI.„..A©S9 

IBM Visual Age 2,0 

1BM17H7495-EI.*1549 

Mesa/2™ 

ADS203100-EI ....,*189 

MKS Source Integrity for OS/2 

MKSIO31O0-EJ ..,.,,*360 

OnCmd XBase for OS/2 

OLDCX31GOEJ..,...*240 

Opt Tech Sort 

OPQTSGIOG-EL.... *240 

Prommare Designer 

PRDG03100-EI......*640 

Watcom C/C++ VI 0.3 Competitive Upg. 
WACCrmS-El....^89 


Up 

VMexx 



Watcom VX*Rexx 
Client/Server 2.1 

by Watcom International 

A visual development environment 
for OS/2. Powerful connection, query 
and chart objects allow you to access 
several databases, manipulate data 
and chart the results quickly and 
easily. Features include: drag-and- 
drop programming; bound controls; 
and professional multi-threaded, 
multi-windowed and drag-and-drop 
enabled application development. 


Discount Price : *281 
Paradise No. W ATV C31 OQ-EI 



SPF/PC Version 4.0 

by Command 
Technology Corp. 

Provides a familiar environment 
no the PC for ISPF/PDF main¬ 
frame programmers. Includes: 

Modifiable Panels & Table 
Services; UNDO/REDO; Program 
Source Colonzation; SUPERC file comparison; vertical splits; 
mouse support; 64,000 max record length; 132-column support; 
and 20+ new r primary commands. SPF/PC features; full 3270 
compatibility; ISREDIT macros via REXX: ASCI I/EBCDIC 
file editing; COBOL workbench integration; CUT/PASTE: 
fully mappable keyboard; and keyboard macros. 

Discount Price: *199 
Paradise No, CTSP43IOO-E1 


rwuwuwAiRWw’ 


1163 Shrewsbury Avenue 
Shrewsbury, NJ 07702-4321 


Call for shipping 
charges/return policies. 
PRICES SUBJECT TO CHANGE. 


Order Now! 800 


Phone order 

800 445 7899 

FAX order 

308 389 9227 

International Sales 

308 339 9229 
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If you’re looking for fast and easy application 
development for OS/2, then take a look at the award- 
winning Watcom VX*Rexx visual development 
environment. VX*REXX lets you build applications to 
exploit the graphical user interface, multi-threading, 
and multi-processing power of OS/2. VX*Rexx 
C lient/Server Edition gives you the added power to 
access DB2 or other database systems, manipulate the 
data, and chart the results at lightning speed. 
tl We like VX'Rexx. Using it for development feels tike 
driving a Porsche: it y s fast, it's compact, everything r s 
in the right place , and it makes us look good, too. ” 

Peter Coffee, PC WEEK 

Designed to Meet Your Needs. 

Watcom VX*REXX combines a project management 
facility, visual designer and an interactive debugger to 
deliver a highly productive visual development 
environment. The Client/Server Edition includes 
additional powerful objects so you can rapidly create rich GUI database 
applications. You can create OS/2 client applications which connect to 
DB2/2 or DB2/6QOO. Use IBM's DRDA support on OS/2 to access DB2 lor 
MVS, DB2/400 for AS/400, and DB2/VSE and VM (SQL/DS) for VM and 
VSE. Also supported are Watcom SQL and ODBC-enabled databases'. 
“Overall, this edition of VX*Rexx for OS/2 is an outstanding visual 
client/server development platform. ” Nicholas Petreley, Info World 


Point. Click. And Presto! 

To create an application you draw user interface objects, customize their 
properties using standard OS/2 notebooks, and define their event code using 
powerful drag-and-drop programming. To add database access just draw a 
query object, visually design a SQL query, press OK and presto— your 
window is automatically populated with objects that are bound to your 
query to display, update and search your data. 

“Drag-and-drop nirvana ” Nicholas Petreley, Info World 

Give Your Data a Whole New Image. 

Energize your applications by displaying your data in a 
3D chart. The Client/Server Edition gives you more than 
a dozen chart types to choose from, along with over 150 
display options. You also get complete support for run¬ 
time events so you can bring new drama to your data by 
making your chart interactive. 
u VX*Rexx is a must buy. “Jacques Surveyed 
ComputerWorld 

Standard or Client/Server Edition— 

Which one is for you? 

To start creating powerful OS/2 GUI applications right away, am* 
order your copy of Watcom VX*REXX Standard Edition for just.... $99 

Or, to start creating rich c lien t/server database appl ications, 

order Watcom VX-Rexx Client/Server Edition for just... ,..$299 




* Over 2 dozen objects, 
including CUA'9i 
containers, notebooks, 
pop-up menus and more 

* Integration and control 
of existing applications 
through DDE, keystokes 
or REXX APIs 


* Easy to learn event- 
driven programming 
model with complete 
on-line documentation 

■ Support for professional 
multi-threaded, multi- 
windowed and drag-and- 
drop enabled applications 

* Code reusability through 
section and file sharing 


• Graphically create CUA'91 
Presentation Manager 
objects, quickly 
customize their properties, 
and easily attach REXX 
procedures 

• Package your application 
as an EXE or PM macro for 
royalty-free distribution 



1-800-265-4555 


Watcom 


A Powersoft Company 


Witcwn international 415 PtuAp sttefl. Waterloo. Orttmo. Canada N?i 3x2 Tel (Si4 1 006 -3700 f519) ?4f49v'' Prices, and spttjfrjrtcris arc subject id ctiange wittraut ikhic* Pnra does not mcfcide freight and tane *here apttvabie Prices gutted a US doftirs 
* ODBC driven are available Irom INTERSOLV Inc. Watcovn. tlw bgtiftiwifl Dew*, and VfrftEn are iradernarlss tt Watcom international CapaflfM.Oiw tr*temarts ate properties tt (heir respective owners. CCoftrigM 19W Wsitcuti intenutMnal Conmnuiori. 
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=~ Editor's^ 
=Comments 


By DICK CONKLIN 


Serving 
Our Clients 


C i 

c 

t 


l lient/server development has been one of 
our most popular themes since we started. 
* And why shouldn’t it? Downsizing is the 
theme of the '90s, and many a mainframe has 
yielded to a distributed network of desktop PCs 
and servers. There's no better C/S platform than 
OS/2* The popularity of client/server applications 
is also reflected in the best-selling computer books 
list Our favorite examples are the books from Bob 
Orfali and Dan Harkey (you saw them here first, 
folks!). Bob and Dan (and Bob s wife Jeri) have an 
amazing talent for making complicated subjects 
easy to understand. If it takes little Martian cartoon 
characters to get a point across, that's fine with me! 
In this issue, we once again welcome Bob and 


changes, but no letup in the 
flow of practical articles 
about OS/2 application de¬ 
velopment. As always, we 
greatly appreciate your feed¬ 
back, your suggestions, your 
subscriptions, and of course 
your support. Don't be shy— 
we like to hear from you! 



Dkk Conklin 



Dan back to OS/2 Developer . You guessed it—here's 
an excerpt from yet another new book—their 

Contact 

CompuServe 

Internet 

Essential Distributed Objects Survival Guide . 

Dick Conklin 

76711,1005, t>r 

os2mag 

While we r re at it, let's welcome Steve Krantz to 

(Editorial) 

052DF2 Forum 

@vnet. ibtn.com 

the ranks of client/server authors. Steve's article is 

Miller Freeman 

76001,2317 

m Johnson 

taken from his new book, to/ World Client/Server, 

(Circulation) 


©mficorn 

an interesting commentary on one large corpora¬ 

Peter Westerman 

76307,1054 

pwesterman 

tion's migration to a C/S platform. The company? 

(Publisher) 


©mfi.com 

None other than IBM itself. 

Theresa Mori 


tmori 

This issue completes our seventh year of pub¬ 
lishing this magazine. In 19%, you'll see some big 

(Managing Editor) 


@mli,com 
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OS/2 Toolbox 

This issue, our OS/2 Toolbox column reviews CCC/Manager 3 . 0 . Id. 

ByGUYSCHARF 


CCC / Manager 
for OS/2 



Guy Scharf 


Mm on figuration management consists 
m of much more than simple version 
control and being able to recover 
prior versions. Softool Carp, has released 
CCC/Manager for OS/2 to address these 
needs, I reviewed the recently released ver¬ 
sion 3.0,ld. 

CCC/Manager provides traditional 
version control features, with change and 
component management to allow access to 
historical versions of any file. But it also 
provides much more. Virtual configurations 
define multiple views of a project for differ¬ 
ent stages of a project, test, or production 
area, as well as any other view that you 
define. Packages group changes from multi¬ 
ple modules to a single unit that can now r be 
migrated from development to test, release, 
or production status. Auditing and Access 
Control functions allow you to monitor 
activity and to ensure integrity of your soft¬ 
ware. CCC/Manager's strength is its ability 
to manage change in a complex environ¬ 
ment, more than it is version control per se. 

CCC/Manager stores version and con¬ 
figuration information in a database that by 
default reflects the directory structure of 
the project. While the database need not 
reflect the directory tree used for the projec¬ 
t's source code, the default paths presented 
for different operations will be more useful 
if it does. When managing multiple prod¬ 
ucts, each should be in its own database to 
use CCC/Manager's release mechanisms 
effectively. 

CCC/Manager is licensed for the num¬ 
ber of users who will be logging into it. 
Concurrent licensing is available for larger 
installations. 


USING CCC/MANAGER 

I installed CCC/Manager from two disks. 


Installation proceeded normally, except that 
the installation program demanded write 
access to the installation disk to update a 
DLL file, A 39-character license key, with a 
mixture of upper- and lower-case letters 
and special characters, has to be typed in 
during installation. CCC/Manager uses 
InstallSHlELD, with its well-known inabil¬ 
ity to handle long lines in CONFIG.SYS. 
The installation program detects this situa¬ 
tion and advises you to change PATH and 
LIBPATH manually. In my testing, I did not 
have to to make these changes at all. 

My first glimpse of CCC/Manager was 
inauspicious. I opened the demo database 
and was presented with three garbled win¬ 
dows. CCC/Manager's main windows are 
implemented as dialogs with a menu and 
sizing border This approach results in com 
trols that overwrite the title bar and border 
if the dialog is sized smaller than its con¬ 
trols. Fortunately, this is easy to fix: simply 
resize the windows so that all the controls 
are visible within the windows' borders, 
and then don't adjust the window sizes 
again. 

Each time you start CCC/Manager, 
you must login to the database with your 
user name and password, the fully qualified 
path to the database, your working direc¬ 
tory, and, optionally, the name of a configu¬ 
ration file. While CCC/Manager does not 
remember this information from one use of 
the program to the next, it does allow all of 
it to be specified on the command line. You 
can easily create a program object on the 
desktop, or a command file, with the 
required information passed as parameters. 

CCC/Manager has four main windows 
and a session log. From the File window, 
you can check in files and administer users 
and the database (Figure 1). Figure 2 shows 
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the Item window from which you can check 
out files, manage locks, create reports, and 
compare and merge files. The Configurations 
window lets you create and manage 
releases and phases (Figure 3). From the 
Packages window, you can define packages 
of changed modules to group changed 
modules together for migration and promo¬ 
tion. The Session log shows the result of 
most operations (Figure 4). 

Directories are shown in a tree view, 
using a custom CCC/Manager control. This 
control is more compact than a container, 
and it works well. 

When you begin using CCC /Manager 
for a project, first define your users and 
groups of users. Access control is extensive; 
more than 30 functions can be allowed or 
disallowed for a user working on a specific 
configuration. An audit log is optionally 
maintained, and you can specify which of 
six classes of events are to be logged. 

The power of CCC/Manager comes 
with its configurations that you create to 
represent a product life cycle. You must cre¬ 
ate a baseline configuration and load the 
application into the database for that con¬ 
figuration. Creating the baseline is easiest if 
your product is contained within a single 
directory tree. When you load the product 
Into the database, CCC/Manager records 
the current status of all modules and 
defines that as a baseline* Versions of files 
are recorded as forward deltas to reduce 
check-in time. With the baseline estab¬ 
lished, you can define other configurations 
that are derived from the baseline. For 
example, you might have separate configu¬ 
rations for development, test, and produc¬ 
tion versions of the product* It is easy to 
define these configurations and their rela- 
tionships to each other. 

Checking out and checking in of files is 
straightforward. You check files out using 
the items window and check them back in 
from the file window. By default, files are 
locked exclusively so that only one person 
may have a file checked out* You may 
change a database to use concurrent locking 
instead of exclusive locking. With concur¬ 
rent locking, several people may check out 
the same file. When you check the file back 
in, CCC/Manager will inform you if 
changes have been made since you checked 
it out. A merge tool will merge your 
changes with any other changes and then 
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Figure 1 . Fife window for fife check-in and user and database functions, 



Figure 2. item window for fife check-out. 



Figure 3. Configuration window. 



Figure 4 , Session fog. 
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give you the opportunity to review 
the combined file and edit any con¬ 
flicts. CCC/Manager also supports 
version branching and duplicate 
directories as ways to accomplish con¬ 
current development. For long-term 
concurrent development projects, the 
better solution may be to define two 
development configurations, each 
derived from the same base configu¬ 
ration* These two configurations can 



CCC/Manager's strength is its 
ability to manage change in a 
complex environment. 


then be merged to create a common, 
merged configuration for integration 
testing and later promotion to test 
and production status. 

Version and Change reports show 
a summary and detail of all changes* 
The output is written to the session 
log rather than being displayed in a 
window or file of its own. The session 
log can easily be written to disk for 
later review if desired. 

As files are checked in and pro¬ 
ject development progresses, you will 
eventually want to move some or all 
changes from the development to the 
test directory. CCC /Manager allows 
you to group changes to multiple files 
together in a package. You simply 
select all the files to be included in the 
package by the change names 
assigned when the files were checked 
in. Once the package is complete, you 
can migrate the package to another 
configuration. From any configura¬ 
tion, you can promote a package to a 
source code directory tree. Promoting 
consists of extracting the source code 
for the files in the package and plac¬ 
ing it in the target directory tree. 
From there, you can recompile the 
configuration and confirm that every¬ 
thing still works. 

Eventually, you have a new 
release. You define the new release as 
a new baseline configuration and cre¬ 
ate new development and test con¬ 
figurations derived from it. Any 
pending changes from the prior deve¬ 
lopment and test configurations are 
merged forward into the new configu¬ 
rations, which replace the old ones for 
continued development. 

You might also want a configura¬ 


tion for emergency fixes to the pro¬ 
duction version. It is easy to merge 
changes from the emergency fix con¬ 
figuration back into the development 
configuration so that they are inte¬ 
grated into the mainline code, 

DOCUMENTATION 

Documentation for CCC/Manager 
consists of the 14-page CCC/Manager 
Installation Guide , the 80-page CCC/ 
Manager Primer , 
and the 290-page 
CCC/Manager Users 
Guide. The Primer 
takes you through 
creating a project, 
defining new con¬ 
figurations, check¬ 
ing in and checking 
out changes, pro¬ 
moting versions, 
and merging versions. While the 
Primer is written for the Windows 
product, 1 had little problem "men¬ 
tally" converting to the equivalent 
OS/2 windows. The icons are named 
slightly differently, and there are dif¬ 
ferences in the default actions and 
window layouts, but these did not 
interfere with learning how to use 
CCC/ 

Manager. 

The CCC/Manager User's Guide 
describes every function of the prod¬ 
uct in detail. I found the manual to be 
clearly written, and it was easy to find 
what I was looking for. 

The documentation explains con¬ 
figuration manage¬ 
ment well and in 
more detail than 
my brief summary. 

An accompanying 
white paper, titled 
Application Manage¬ 
ment; Using Virtual 
Configurations ex¬ 
plains the philoso¬ 
phy and application 
of configurations in 
more detail. 


doesn't always do what might be 
expected. It appears that Softool 
intended the windows to be resizable, 
with the listboxes within the windows 
displaying more or less information* 
But this was not implemented, and 
the sizing border was left enabled. It 
would have been better to have dis¬ 
abled the sizing border, if Softool 
wasn't going to implement window 
sizing. These problems are irritating 
but do not seriously affect usability. 
Softool has said that it is addressing 
these issues. 

When you check in or check out a 
file, or perform other operations, you 
must examine the session log to deter¬ 
mine if the operation was successful. 
For most operations, no error window 
is displayed or bell sounded if the 
operation fails; you must watch the 
session log constantly. This approach 
is more reminiscent of exception 
reports from mainframe configuration 
management applications than it is of 
a good graphical user interface. 

The check-in window would be 
simpler if a filter was used to show 
just unchecked-in files. Without a fil¬ 
ter, you have to examine the entire 
directory to locate the files that are to 
be checked in* Both of these design 
issues will contribute to user error. 

Don't dose the Session Log win¬ 
dow. I couldn't get it back without 
stopping and restarting CCC/Manager, 
It's OK to minimize this window, 
though. 

CCC/Manager will optionally 


CCC/Manager provides well- 
thought-out functions for 
managing versions and 
releases. 



WARTS AND BLEMISHES 

The documentation states that CCC/ 
Manager's windows are designed to 
CUA standards. It would have been 
better if this wasn't stated—the win¬ 
dows violate CUA in many respects. 
Interestingly, the windows shown in 
the manual comply better with CUA 
than do the windows of the actual 
product. The problems are many; for 
example, mnemonics are used inap¬ 
propriately, and multiple selection 


insert the revision history or eight 
other pieces of information in the file 
as it is checked out. However, the 
comment delimiters for the revision 
history are defined for the database, 
not for the file extension. Thus, it may 
be difficult to include revision history 
on files that require a different com¬ 
ment delimiter than is used for most 
of the files in a project. 

Most windows are not refreshed 
automatically to reflect changes in 
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directories or files. It would be more 
convenient if the lists in the windows 
were always maintained in their cur¬ 
rent form, even if changes were made 
outside of CCC/Manager. 

LIMITS OF APPLICABILITY 

CCC/Manager is designed for the 
company that wants to manage its 
products and control changes. It sup¬ 
ports multiple releases of products, as 
many phases (such as development, 
test, production) as your organization 
might want, client-customized ver¬ 
sions of products, and emergency fix 
configurations. Virtual configurations 
are the strength of CCC/Manager and 
can be applied to solve many configu¬ 
ration management problems. 

If you are looking for a program¬ 
mer's version control tool, you proba¬ 
bly won't like CCC/Manager. While 
command-line programs for check-in 
and check-out are provided, they are 
DOS programs requiring special DOS 
Settings. It may not be easy to inte¬ 
grate those tools with your editor or 
other development tools. 

TECHNICAL SUPPORT 

Technical support is available by tele¬ 
phone and e-mail. Softool has also cre¬ 
ated World Wide Web pages for a con¬ 
figuration management information 
center. Information articles are avail¬ 
able on basic configuration manage¬ 
ment principles, tips for implementing 
configuration management in an orga¬ 
nization, and lifecycle and process 
management. The configuration man¬ 
agement web page is located at http: 
/ / www.softool.com/CMCenter.html. 

SUMMARY 

CCC/Manager will appeal more to 
organizations that need to manage 
multiple versions of products or are 
ready to adopt a formal change man¬ 
agement strategy than to organiza¬ 
tions needing only simple version 


PRODUCT INFORMATION 

CCC/Manager for OS/2.$495 

Annual maintenance.$85 

Vendor: Softool Corp. 

340 S. Kellogg Ave. 

Coleta, Calif. 93117 
Phone: (805) 683-5777 
Fax: (805) 683-4105 
Internet: info@softool.com 


control. I like CCC/Manager for man- 
aging projects. It provides well- 
thought-out functions for managing 
versions and releases as well as batch¬ 
ing changes. The availability of the 
product on diverse platforms should 
be attractive to installations managing 
projects that span several platforms. 

As a programmer, I would like 
better integration with my editors and 
other development tools to increase 
flexibility in checking out and check¬ 
ing in modules on an ad hoc basis 
during development. The user inter¬ 
face could be much improved by care¬ 


ful attention to Presentation Manager 
details and CUA guidelines. Softool 
has said that an upgrade to address 
user interface issues and to add OS/2 
command line utilities will be 
released soon. I am looking forward 
to seeing these changes. 

Guy Scharf is president of Software Architects 
Inc., a software development firm specializing 
in developing OS/2 Presentation Manager 
applications for vendors and business. He can 
be reached at CompuServe 76702,557 or at 
Software Architects Inc., 2163 Jardin Dr., 
Mountain View, Calif. 
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You know how applications look. 


ow to click a mouse. 


You know how to draw a line. 
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This concludes your training in 
00 programming with VisualAge. 


No one’s debating the benefits of object- 
oriented programming. The only question is 
whether it’s worth the time and money it 
would cost to implement. 

With VisualAge', - the question may be 
irrelevant. Because its simplicity can easily 
remove the barriers between you and the fast 
development of 

object-oriented Can y O U T soft 

applications. 

VisualAge is light years beyond mere GUI 
builders. It’s a graphical environment that takes 
you through the entire process, from interface 
design to working application. As InfoWorld 
puts it, “a masterpiece of visual programming.” 

With the C++ edition, you work with 
“parts” from IBM’s Open Class 
Library, creating visual links 
between them. They’re easy to 
modify and compliant with stan¬ 
dards, so they can be used across 


platforms, from PCs to the biggest servers. 

When your project is complete, you’ve 
created an application with industry-standard 
code (C++ or Smalltalk). And in a fraction of 
the traditional development time, you’re ready 
to deploy a true object-oriented application, 
with solid components that can easily be used 

over and over in 

ware do this? future projects. 

Of course, your 
full 00 solution requires even more. That’s 
why IBM offers more 00 products, consulting, 
education and services than any other software 
company. To quickly take advantage of 00 
technology, call 1 800 IBM-3333 ext. GA 070 
or visit http://www.software.ibm.com. You’ll 
find that you’ve been in training for 
VisualAge all your life. 
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This is the first in a senes of articles, which uncover the hidden details of bitmaps and 
their manipulation. 

By MARK BENGE and MATT SMITH 


What's In a Bitmap? 



Matt Smith 


f very one is affected by the bitmap, 
yet most of us really don't under¬ 
stand how they work or are con¬ 
structed. Various bitmap formats are defined 
within OS/2 to the extent that they seem con¬ 
voluted and complicated. To compound 
things, there is a form of bitmaps that is effec¬ 
tively an array of images. 

Over the next few issues, we will jump 
paws-first into bitmaps to try to learn how 
they are defined, how we can display them 
directly from bitmap files, and how to manip¬ 
ulate them and perform some really neat 
tricks with them. Along the way, we will try 
to explain some of the more mysterious 
details of bitmaps, such as ROPs. 

So, where do we begin? How about we 
look to the origin of bitmaps? 

A QUICK HISTORY LESSON 

In the beginning, there were two types of dis¬ 
plays used for interactive graphics. One was 
the random-scan vector display. This display 
type can be thought of in a similar fashion to 
that of the plotter. Using vector-type com¬ 
mands, it would draw lines and arcs on a 
cathode-ray tube. You would only need to 
give the display a starting point and an end¬ 
ing point, and it would draw the line. 

The second type, the raster-scan display, 
became the more prevalent type. The raster- 
scan display can be thought of in a similar 
fashion to the dot-matrix printer. Information 
is recorded on a dot-by-dot basis. These dots 
are commonly known as pixels. 

The major difference between the two 
display types is that the vector display con¬ 
tains only the information regarding the 
starting and ending points of lines and char¬ 
acters with the middle or void areas being 
ignored, whereas the rasteT display is respon¬ 
sible for each element (point) that constitutes 


each line or character. Therefore, much more 
information needs to be recorded by the 
raster display than by the vector display. 

So, why the raster vs. the vector? Two 
real reasons. The need for a realistic display 
of images played heavily in favor of the 
raster display since it could display a three- 
dimensional image with greater ease than the 
vector display. The second reason was cost. 
Initially, the high cost of raster displays was 
due to the large amount of memory required 
because each addressable pixel required 
memory to record its state. A larger amount 
of memory was necessary to store the infor¬ 
mation within a raster display than a vector 
display. However, the costs dropped, and the 
raster scan display prevailed. 

INTO THE HERE AND NOW 

What is a bitmap? Well, as the name sug¬ 
gests, if s a map of bits. Yeah, right... 

Just like a geographic map, each relevant 
item within that map describes a location, 
Los Angeles has a location of 34 O'N 118 
ID'W, whereas London is 51 3G'N 0 5'W, You 
cannot transpose these two locations. 

Bitmaps are similar. A pixel, which is 
defined for location, cannot be transposed 
with a different pixel in a different location. If 
you do transpose them, the meaning of each 
would be different. 

Bitmaps as we know and use them today 
really just describe a color at a particular 
location. When the colors are combined, we 
interpret them through the mechanics of the 
eye and then apply meaning to what we see. 

BITMAP CONCEPTS 

Essentially, the bitmap is a record of the color 
of a particular pixel position. With raster dis¬ 
plays, this is 2,16, 256, or 65,536 (64K) colors. 

Many different schemes can be created 
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to record this pixel, and, essentially, the 
bitmap tinder OS/2 is one of those schemes. 
To make things more difficult, how do you 
ensure that a given bitmap can work on the 
different display types, with different capa¬ 
bilities and resolutions? 

DEVICE INDEPENDENCE 

The structures that are used within OS/2 to 
describe bitmaps have been designed with as 
much device independence as possible. 
During the days of OS/2 1.1, there was a sim¬ 
ple bitmap definition. This definition defined 
the bitmap for a given device, which meant 
you had to create different bitmaps for each 
of the resolutions handled. Then, you had to 
save these bitmaps within the applications' 
resources using different IDs. Finally, at run¬ 
time, you had to determine the resolution 
you were dealing with and then pick the 
appropriate bitmap image from the applica¬ 
tions' resources. Seemed like a lot of work. 

Beginning with OS/2 1.2, the design 
goal of the bitmap was device independence 
so that one bitmap could contain different 
images of the bitmap, thus allowing the 
image that was appropriate for a given 
device to be selected. 

Now you know why the bitmap appears 
to be so difficult. Instead of creating two, 
three, or four images of a bitmap for a set of 
different resolutions, you could create one 
bitmap (known as a bitmap array) that con¬ 
tained the different images for the different 
resolutions. Then, inside your PM applica¬ 
tion, you would only need to select the one 
bitmap through GpiLoadSitmap, and the system 
would figure out which of the images in the 
bitmap array would suit the particular dis¬ 
play on which the application was running. 

And to make life more fun, the struc¬ 
tures that were introduced in OS/2 1.2 were 
revised and expanded for OS/2 2.0. (All of 
the necessary structures for both OS/2 1.x 
and 2.x are contained within the PMBIT- 
MAP,H header with the 2.x structures ending 
with a 2.) 

Part of these changes were supposed to 
make it easier to create device-independent 
bitmaps, but some changes really are not 
very effective, 

THE STRUCTURE OF A BITMAP 

The simplest OS/2 bitmap consists of a struc¬ 
ture, B1TMAPF1LEHEADER or BITMAP- 
FILEHEADER2, a color table, and the image 


data. Listing 1 shows the structure values for 
the bitmap image of Figure 1. 

Basically, the structure describes the 
bitmap through a series of fields. The most 
important fields to pay attention to are con¬ 
tained in the BITNAPINFOHEADER or BITMUPINFO* 
HEADER2 portion of the structure. The cx, cy, 
and cBitCount fields are used to describe the 
width and height of the bitmap and the num¬ 
ber of colors in it. The cBitCount field defines 
the number of bits defined by each pixel posi¬ 
tion within the image data. 

The following table depicts the number 
of colors as defined by cBitCount: 


BimPFILEBEA[>EK2 bfh2: 

USHQRT usType = BFT JWIP 

ULOMG cbSize = 7B 

SHORT x Hotspot - 25 

SHORT yHotspot = 25 

ULONG ofTBits = 142 

BXT«APIWFOHEJIDER2 bfh2,bmp2- 


ULONG cbFi* 

64 

ULONG cx =50 

ULONG cy =50 

USHORT cPlanes 

= 1 

USHORT cBitCount 

- 4 

ULONG ulCompcession = BCA JNCOHP 

ULONG cblmage 

= 0 

ULONG cx Resolution 

p 0 

ULDNG c/Resolution 

= 0 

ULONG cdrUsed ■ 

= 0 

USHORT usUnits 

= BRU_METRIC 

USHORT usReserved 

= 0 

USHORT usRecordi/ig 

= BfllJQTTGMUP 

USHORT usRendering 

= BRH_W0TH ALFTOMED 

ULDNG cSizel 

0 

ULONG c$ize2 

0 

ULONG ulColorEneeding = 8 CE.RGB 

ULONG ulldentifier 

- 0 

argbColor[ 0] 

= 0 x 00000000 

argbColorf 1 ] 

= 0x00000080 

argbColor[ 2] 

* 0x00008000 

argbColor[ 3] 

= 0x00008080 

argbColor[ 4| 

= 0x00800000 

argbColor[ 5] 

= 0x00800080 

ergbColor[ 63 

= 0x00808000 

argt>Color[ 7] 

= 0x00808080 

argbColor[ 8 ] 

= OxOOcccccc 

argbCelort 9 ] 

= OxOOOOOOff 

argbColor[ 10] 

= OxQOOQffOO 

argbCclor[ 11] 

* OxOOOOffff 

argbColor[ 12] 

= OxOOffOQOO 

argbColor[ 13] 

= OxOOffOOff 

argbCelerf 14] 

= OxOOffffOO 

argbColori 15] 

= OxOOffffff 


Listing 1 . Bitmap structure values , 
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Figure 1 . Sample bitmap image. 


cBitCount colors 

2 2 

4 16 

8 256 

16 65,536 

The easiest way to determine the 
number of colors is to take the value of 
the cBitCount and rotate it left 16 posi¬ 
tions: 

coolers = bfh2.bmp2,cBitCount « 16 

If the number of colors for the 
bitmap are 256 or less, an RGB color 
table resides immediately after the 
BITHAPFILEHEADER or BITMAPFILEHEADER2 
structure. It will contain either 2,16, or 
256 entries depending on the cBitCount 
value. 

If the bitmap is a 64-K color 
bitmap, each item within the bitmap 
data is an RGB value. 

So why the difference? Quite sim¬ 
ply, because space is required to record 
the image. And, consequently, this is 
another area that makes the decoding 
of the actual bitmap data interesting. 
The easiest (and also most diffi¬ 
cult) way to understand this is to look 
at the actual image data for the various 
color types supported. Here we will 
look at a three by three image in % 16, 
and 256 colors as well as 64-K color 
representations (Figure 2), To conserve 
space and also make the examples eas¬ 
ier, we are using the OS/2 Lx structure 
definitions. Each square in Figure 2 
represents a pixel. 

As you look at each of the struc¬ 
ture definitions, you will really only 
notice a few changes between each of 
them. The offBits element will differ as 
a result of the color table between the 
structure and the image data. The 
cBitCount held will contain the appro¬ 
priate value for the bitmap defined. 
Other than that, the values are the 
same within the structures, 

14 


As would be expected, the color 
table information will be different for 
each of the different bitmaps. And 
finally, the image data itself will be 
different. 

For the two-color bitmap, the 
header is: 

BITMAPFILEHEADER bfh: 

USHORT usType = BFT.BHAP 
ULONG cbSize = 26 
SHORT xHotspot = 1 
SHORT yHotspot = 1 
ULONG offBits = 32 
SrTHAPXNFOHEJOER bfh.bmp: 

ULONG cbFix = 12 
USHORT cx * 3 
USHORT cy * 3 
USHORT cPlanes = 1 
USHORT cBitCount = 1 
argbColorf 0] * 0x00000000 
argbColorf I] = OxOOffffff 

The image data is: 

hooooooo4oooooooaooooooo 

For the 16-color bitmap, the header 
looks like: 

BITHAPFILEHEADER bfh: 

USHORT usType = BFT.BHAP 
ULONG cbSize = 26 
SHORT xHotspot = 1 
SHORT yHotspot ® 1 
ULONG offBits = 74 
BUM!PINFQHEADER bfh.bmp: 

ULONG cbFix = 12 
USHORT cx =3 
USHORT cy =3 
USHORT cPlanes = 1 
USHORT cBitCount * 4 
argbColorf 0] = 0x00000000 
argbColorf 1] = 0x00000080 
argbColorf 2] = 0x00008000 
argbColorf 3] ^ 0x00008080 
argbColorf 4] = 0x00800000 
argbColorf 5] = 0x00800080 



Figure 2. Three by three bitmap image. 
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argbColorf 6] = 0x00808000 
argbColorf 7] = 0x00808080 
argbColorf 8] = OxOOcccccc 
argbColorf 9] = OxOOOOOOff 
argbColorf 10] = OxOOOOffOO 
argbColorf 11] * OxOOOOffff 
argbColorf 12] = OxOOffOOOO 
argbColorf 13] = OxOOffQOff 
argbColorf 14] = QxOOffffOO 
argbColorf 15] = OxOOffffff 

and the image data: 

FOFOOOOOOFOOOOOOFOFOOOOO 

The 256-color bitmap header looks 
like (there are 256 items for the color 
table, only a few are shown here): 

BITNAPARRAYFUEHEADER : 

USHORT usTjfpe = BFT.BITMPMIW 
USHORT cbSize = 40 
USHORT offlext = 0 
USHORT ex Display = 1024 
USHORT q/Dlsplay = 768 
BITHAPFILEHEADER bfh: 

USHORT usType = BFT.BHAP 

ULONG cbSize * 26 

SHORT xHotspot = 1 

SHORT yHotspot = 1 

ULONG offBits * 908 

BITHAPIHFOHEADER bfh,bmp: 

ULONG cbFix = 12 
USHORT cx =3 

USHORT cy ■ 3 

USHORT cPlanes = 1 
USHORT cBitCount = 8 
argbColorf 0] - 0x00000000 
argbColorf 1] = 0x00000080 
argbColorf 2] = 0x00009200 
...argbColor[254] = OxOOfTf7f7 
argbColor[255] * OxOOffffff 

OFOOOFOOOOOFOOOOOFOOOFOO 

Finally, for the 64-K color bitmap: 

BITHAPARRAYFILEHEADER : 

USHORT usType = BFT.BITHAPARRAY 

USHORT cbSize = 40 

USHORT offNext * 0 

USHORT cxOisplay = 0 

USHORT cyDisplay = 0 

BITHAPFILEHEADER bfh: 

USHORT usType = BFTJHAP 

ULONG cbSize = 26 

SHORT xHotspot * 1 

SHORT yHotspot = 1 

ULONG offBits * 140 

BITHAPINFOHEADER bfh.bmp: 

ULONG cbFix = 12 
USHORT cx =3 
USHORT cy =3 
USHORT cPlanes = 1 
USHORT cBitCount = 24 













Figure 3. Bitmap viewer 


and the image data: 

FFFFFFOOCXXJOFFFFFFOOOOOO 

OOOOOOFFFFFFOOOOOOOOOOOO 

FFFFFFOOOOOOFFFFFFOOOOOO 

So what J s the big deal? The magic 
of completing the bitmaps' interpreta¬ 
tion lies within the image data itself. 
What the data represents {except for 
the 64-K color bitmaps) is an index into 
the RGB color table for the pel position. 

Consider a 16-color bitmap. It will 
have a color table of 16 elements. 
Therefore, if we had: 

5 7 9 
1 3 8 

6 4 2 

the first pel would be RGB[5] and the 
second pel would be RGB[7]. 

This is the concept; the trick lies in 
the actual representation within the 
bitmap. What this really means is that 
depending on the number of colors, the 
index position is defined differently. 

For the two-color bitmap, the 
image data is (we are showing it in row 
format to make it easier to see how the 
data corresponds to the image): 

*0000000 

40000000 

*0000000 

When you look at this, youTl find 
it difficult to understand the data. Each 
row (or scan line) within the bitmap 
data (and this applies to all bitmap 
data) must begin on a 32-bit (ULQNG) 
boundary. 

A two-color bitmap index is very 
simple. There are only two index val¬ 
ues, 0 and 1. Therefore, each of the bits 
for the two-color bitmap consists of a 
series of bit index values. By changing 
the above to binary, you get for each of 
the rows: 

1Q1QCK)00000^ 

GiQOMOOOO^ 

101000000000^ 


See the pat¬ 
tern? Each byte 
would then con¬ 
tain eight pel in¬ 
dex values. 

The 16-color 
bitmap operates 
in a fashion that 
is similar, only 
this time it looks 
like: 

FQF00000 

OFGOOOOO 

FOFOOOOO 

Here, each RGB index is repre¬ 
sented by a nibble (4-bits) instead of a 
bit 

A 256-color version of the bitmap 
looks this way: 

OFOOOFOO 

QOOFOOOO 

OFOOOFOO 

using each byte as the index to the RGB 
color table. 

Finally, the 64-K bitmap represents 
each pel with the RGB color value 
(each RGB colors is 3-bytes): 

FFFFFFOOOOOOFFFFFFOOOOOO 

QOOOOOFFFFFFOOOOQOQOOOO0 

FFFFFFOOOOOOFFFFFFOOOOOO 

With this now under our belts, it is 
time to look at how we can use this 
information. How about a bitmap 
viewer? 

A BITMAP VIEWER 

One of the best ways to understand 
bitmaps is to build a viewer that can 
read in a .BMP file from disk and dis¬ 
play it. Figure 3 shows the bitmap 
viewer in action. 

Through the File Open menu item, 
you can pick a bitmap file to display. 
This file is then read in from the disk 
and interpreted (yes folks, the opera¬ 
tive word here is interpreted). 

Due to the history of bitmap evo¬ 
lution under OS/2, you'll need to 
structure the bitmap code to interpret 
the information that is being read. 
Because there are two different bitmap 
types, 1.x and 2.x, you'll need to inter¬ 
pret various header information to be 
able to know how to correctly reference 
the data contained. 

Further, the bitmap can either be 
a single image or an array of images, 
which complicates things even more. 
Oh yeah, Windows bitmaps are simi¬ 


lar, but, alas, the header information is 
different. 

So, what have we done to handle 
this? Basically, we read in the entire 
image from the disk into a buffer of the 
appropriate size. Assuming the image 
is an OS/2 bitmap, it can start with one 
of two structures: BIFNAPARRAYFILEHEADER 
or BITHAPFILEHEA0ER for OS/2 1.x type 
bitmaps, or BITHAPARRAYFIIEHEADER2 or 
BITHAPFILEHEADER2 for OS/2 2.x bitmaps. 
The first element in each is usType. The 
second element is cbSize. It is these two 
elements that you should interrogate. 

To determine if you are dealing 
with a BITMAPARRAYFIlEHEADERx, check to 
see if usType is BFT.BITHAPARRAY, which if 
true means you need to interpret the 
data using the BITHAPARRAYFILEHEADERx 
structure. Each bitmap will be defined 
using this structure, and the means of 
walking through the structures from 
one to the next is by checking the value 
of offNext, When this value is 0, you 
have reached the last image within the 
array. 

If the value contained within the 
usType element is BFT.BHAP, you are deal¬ 
ing with a BITHAPFILEBEADER* type of 
structure. 

To determine whether or not the 
structures are 1.x or 2.x types, check 
the values of the cbSize elements. If 
you are dealing with a 1.x type of 
structure, this element will contain the 
value of 

sizeof{BITMAPFILERFADER) 

By checking the size in cbSize, we 
can determine whether we should use 
the 1.x or 2.x structures. 

What this really means is that we 
use similar code to interpret the infor¬ 
mation read in from the disk, except 
that one routine understands 1.x image 
information and the other understands 
2.x image information. 

STACKING THE ODDS 

In our routines, we build a stack of 
images based on the bitmap array data. 
If the bitmap only contains one image, 
we only have one image within our 
stack. This will allow us to display 
whichever image is appropriate. 

Figure 4 shows the bitmap viewer 
with the images from a bitmap array 
bitmap. It also shows the pop-up menu 
that is displayed when you dick button 
2 mouse over the image. This pop-up 
menu allows you to select the informa¬ 
tion to view for the image. 

When you have selected one of the 
pop-up menu items, the information 
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Figure 4. Bitmap viewer showing images from array. 


displayed, like that in Figure 5, is taken 
from the bitmap structures. 

When you select the pop-up menu 
item for the color table, the View Color 
Table dialogue (Figure 6) will allow 
you to edit the color table entries. 

SO WHICH IS THE RIGHT ONE? 

A further dilemma revolves around the 
bitmap array. The question that is 
always asked is, "Which image do 1 
pick?" 

The trick with the bitmap is to 
know how to interpret the header 
information. For the bitmap array 
shown in Figure 4, the following 
depicts the format of the file: 

image 1: SO x 50 x 16 colors 

BITHAPARRAYFILEHEADER2 

BXTHAPFILEHEADER2 

BITNAPINF0HEADER2 

RGB[16] 

image 2: 25 x 25 x 16 colors 
BITHAPARRAYFILEHEADER2 


BITMAPFILEHEADER2 
BITMAPINF0HEADER2 
RGB[16] 

image 3: 50 x 50 x 2 colors 

BITMAPARRAYFXLEHEADER2 

BITHIIPFILEHEADER2 

BITMAPINF0HEADER2 

RGB [2] 

image 4: 62 x 62 x 256 colors 

BITMAPARRAYFXLEHEADER2 

BITMAPFILEHEADER2 

BITMAPXNF0HEADER2 

RGB[256] 

image 1 data 

image 2 data 

image 3 data 

image 4 data 

In the bitmap viewer, you will 
notice that when you pick a bitmap ini¬ 
tially, even if it is a bitmap array, only 
one image is selected. 

The best way to explain this is to 
understand how and why the Icon 
Editor constructs bitmap arrays. The 
previous example 
depicts four images 
contained within the 
bitmap file. The first 
image—50 by 50, 16 
color—is the default 
image. What this 
means is that if none 
of the other images 
are designed for the 
display type, this one 
is used. It is also sup¬ 
posed to correspond 
to a VGA type of reso¬ 
lution, or, as de¬ 
scribed by the Icon 
Editor, Independent 
Color Form (=VGA). 
This format is other¬ 
wise known as low 
res. The second image 
is a special-case 
image. It is described 
by the Icon Editor as 
Small Color Form. It 



Figure 5. Bitmap structure contents . 


is 25 by 25, 16 color, which is exactly 
50% of the size of the Independent 
Color Form image. 

The third image is defined by the 
Icon Editor as Independent BW Form 
(1.1). It is 50 by 50, 2 color—the same 
size as the default image but with only 
two colors. 

Finally, the last image is defined 
by the Icon Editor as 8514. It is also 
known as high res. It is 62 by 62, 256 
color, which is 125% larger than the 
default image, as it is intended for dis¬ 
plays that are 1,024 by 768 or higher 
resolution. 

Now what? How do we use this 
info to determine how to pick the cor¬ 
rect bitmap? Look at the BITMAPARRAY- 
FILEHEADERx fields cxDisplay and cyDis- 
play. If these fields are greater than 0, 
they will contain the resolution for 
which the image was intended. If the 
image is high res, the cxDisplay ele¬ 
ment will contain 1,024 and the 
cyDisplay element will contain 768. If 
the display on which you are present¬ 
ing the image is at least this resolu¬ 
tion, you would use this bitmap array 
image. 

Alternately, if the image is a 2.x 
style image, you could try to use the 
cxResolution and cyResolution ele¬ 
ments of the BITMAPINF0HEADER2 to match 
display resolutions. This value, in the¬ 
ory (and the very operative word here 



Figure 6. View color table dialogue. 
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is theory), would be checked against 
the value contained in CAPS_HDRIZQN“ 
TAL_ftESOLUnON and CAPS JERTICAL.RESOLU- 
TIQN from the Dev Query Caps API. Why the¬ 
ory? Weil, simply put, no two different 
adaptors define the metrics in a similar 
fashion. Also, the display drivers may 
simply use a given model (that is, 1,024 
by 768 while displaying in 1,280 by 
1,024 resolution). 

So, where does this leave us?— 
Low res and high res. Low res can be 
thought of as anything below 1,024 by 
768 resolution and high res as being 
1,024 by 768 and above. 


THE REST OF THE VIEWER 

What else does the viewer do? Well, in 
this version, it scales the bitmap 
images, displays device information, 
and allows you to flip the color table 
around. Why? Basically, to show you 
how to manipulate the bitmap once it 
has been read in from the disk. 

If we wanted to, we could manip¬ 
ulate the image data. It wouldn't be too 
difficult to take an image and invert it. 
All you have to remember is how the 
index values are recorded. 

As an added bonus, the bitmap 
viewer can read in a Windows bitmap 


and display it as though it were an 
OS/2 bitmap, even though the header 
information for Windows bitmaps are 
different, 

NEXT TIME 

Next time, we will discuss that thorny 
issue of ROPs, They really are quite 
simple once you understand the 
basics. 
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You can download BtnpLExe from 
these electronic sources: 

CompuServe's OS2DF2 forum 
(OS/2 Developer section). 

File area 11 on the IBM PCC BBS, 
(919) 517-0001, OS/2 Tools section 
on the OS/2 BBS for IBM TALK- 
Link customers—4tp to the server 
address prominare.com and log in 
as anonymous. The source is lo¬ 
cated in the /pub/prominare/ 
gui comer codecache subdirectory. 

Also check out the new GUI Comer 
home page at www.prominare. 
com/ prominare/guicorner.html. 
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Programming insider 

In this issue's Programming Insider, you will see how you can take advantage of the 
power of the workplace shell, use DLLs to reduce the amount of work in an application, 
and also minimize the amount of code you have to write and debug. 

By DAVID £. REICH 


Drag Me, Drop Me, 
Treat Me Like an Object 



David Reich 


/ n the classic programming and usage 
model, users start a program, open a 
data file, manipulate the data and then 
save and/or print the file. This is an applica¬ 
tion-oriented approach. The application is the 
center of the user's focus, having to be 
launched, fed, and maintained* 

Object-oriented , on the other hand, is 
more than just putting objects in folders on 
the desktop and having objects represent 
your printers and other desktop tools. 
Object-oriented is also a way of thinking and 
a way of having users interact with the vari¬ 
ous parts of the computer. 

In the application-oriented world, all 
you had to do was ensure that your applica¬ 
tion could be started from the shell, and you 
were done. Now, when users are as comfort¬ 
able working with computer objects as they 
are with real objects, you need to change 
your way of thinking about the programs 
you write* You need to look at making your 
program a part of the computer system, not 
just something to be started and used. 

To accomplish this, begin thinking 
about the documents or other objects that 
you want to manipulate (database records, 
files, graphs, or sets of data)* Think of the ob¬ 
jects as the operands and the application as 
the operator, to use mathematical terms* 
From now on, users no longer start applica¬ 
tions, they open objects. The objects are sim¬ 
ply presented to them in the way in which 
they are accustomed to seeing them. If it is a 
graph object, it is presented in their graphing 
program. If it is a database file, it is pre¬ 
sented in their database program or transac¬ 
tion processor, or whatever program they 
use to manipulate their data. 

This presents challenges in writing ap¬ 
plications, and more precisely, object manip¬ 
ulators* These challenges arise in how you 


will use function and how you will architect 
it to be efficient and flexible. 

In the past, I've written about not writ¬ 
ing your application as an object but writing 
an object class (or classes) to represent the 
different types of data you might want to 
store. I've discussed the merits of reusable 
code and using DLLs for a purpose. This 
subject lends itself very well to such coding 
practices. 

OBJECT-ORIENTED PRINTING 

Let's first start with a straightforward sub¬ 
ject: printing. Users of application-oriented, 
graphical software look to the menu bar for 
the File and Print menus. From there, one 
sees some dialog with which to select print 
destinations, paper orientation, and other at¬ 
tributes and then a push button that says Go, 
Print, or OK, The print job is on its way, as 
long as the user knows the printer name, 
some of its capabilities, and other tidbits of 
information that the dialog window might 
require. The user also needs to start the ap¬ 
plication, feed it a data file, and tell it where 
to put it* This is a lot of work to enable a user 
just to take an existing piece of data and put 
it on a printer. 

In the object-oriented world, the user 
knows which folder holds the desired data. 
The user opens the folder, sees the object 
that represents this data, and drags and 
drops it on the printer. The user is then pre¬ 
sented with a window that has some prede¬ 
fined values for paper orientation and such, 
and if no changes are desired, the user says 
OK and the job is off to the printer. The user 
never sees or knows about an application. 
The user only knows that (s)he wanted a 
piece of data printed, dragged and dropped 
it there, and it happened. 

As I wrote last year in my two-parter on 
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"InSOMnia and Workplace Shell Pro¬ 
gramming" (May/June and July/August 
1994), writing an object class to represent 
your documents or data files is not terribly 
involved. It does, however, require SOM 
programming and takes advantage of the 
Workplace Shell programming model. The 
point of this column is not to rehash what 
you've already seen but to expand on it. 

To recap, your task is to enable drag- 
and-drop printing. The system (Workplace 
Shell) default behavior can only print plain 
text or printer-specific files, because OS/2 
cannot, and should not, be expected to know 
about all of the data file formats that all of 
the available applications support. To sup¬ 
port graphical printing through the device 
independence afforded by OS/2, the origina¬ 
tor of the print job must be able to create a 
presentation space and a device context, and 
play or paint the data into the presentation 
space. To do that, the application must also 
know the data format so it can decipher it 
and draw it appropriately. 

Given that the shell cannot be expected 
to know your applications' data format, you 
can force the user to open the application, 
open the data file and choose File, Print, and 
go through the application-oriented way of 
doing things. Or you can provide a way for 
the user to drag and drop a document on a 
printer and eliminate a lot of work. To ac¬ 
complish this task (assuming you do not 
store your data file as plain text or printer- 
specific, in which case your work is already 
done), you will write an object class, most 
likely as a subclass of the Data File class 
(WPDataFile), 

If all you want to do is enable drag- 
and-drop printing, you can override some 
basic methods to give yourself a type and 
an icon along with wpPrlntQbjsct, The 
ypOataFlle class's behavior for upPrintObject 
is to put up the "which type of file" dialog 
and then act accordingly, either creating a 
presentation space and device context and 
drawing the data, or passing it straight 
through with no translation (for printer- 
specific files.). You, however, will be over¬ 
riding tfpPrintdbject and doing something 
different. 

NOW FOR SOMETHING COMPLETELY DIFFERENT 

When an object is dropped on a printer, it 
gets called at the wpPrintDbject method. If the 
class that the object belongs to does not han¬ 


dle or override wpPrintObject, the method call 
is passed to the parent of that class, and so 
on up the chain until it hits a class that han¬ 
dles it. In the case of WPDatafile, that class 
handles the method cal 1 if the subclass does 
not What you are doing is defining behavior 
different from the yPOataFile class's behavior 
for upPrintObject. 

When your object is called at wpPrint- 
Object, it needs to take action to print the 
data object on the printer specified. First off, 
you are given the printer destination and a 
pointer to the object that is to be printed. In 
fact, the method call gives you the entire 
data structure needed to call DevDpenDC to ere- 
ate a printer device context. All you need to 
do is figure out how to take the object 
pointer and get the data from the object and 
interpret it. 

To get the name of the data file that the 
dropped object represents, you can call 
wpQueryRealName, This will give you the file 
name for the file you need to print. Now you 
can see how to use the power of multithread¬ 
ing, code sharing, and the Workplace Shell. 

At this point, you have been called at 
wpPrintDbject, you are executing inside the 
code that you have written to override this 
method in your object class, and you have a 
print destination structure and a file name. 
You could simply call DosExecPgm or Dos Start- 
Session to start your application, pass in a 
flag such as 7p" to specify starring it up in 
invisible print mode, and pass in the print 
destination structure and the file name with 
code in the application to handle it—but that 
is the quick and dirty way. There is a much 
more elegant way to accomplish this, with 
much less overhead and much more reuse of 
code. 

Starting a whole new session or process 
is a high overhead proposition. Most users 
are running in a memory-constrained sys¬ 
tem, no matter how much they have, and 
that much overhead just to print a file is very 
undesirable. 

Rather than take you through the baby 
steps of a more elegant implementation, I'll 
just jump right into it. Use DLLs for your 
printing functions. DLLs are primarily used 
to share code between processes. You may 
say that your program is only one process. 
Remember, however, that your object classes 
run in the Workplace Shell's process. 

If you take the "ugly" approach and 
start the application to print the file, you are 
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incurring all of the overhead associ¬ 
ated with starting the process or ses¬ 
sion, By using DLLs for your print 
function, you can call it from the appli¬ 
cation when needed, or from another 
process such as the Workplace Shell 
process (and not load the code until or 
only if you need it). Let's look at the 
mechanics. 


this .LIB file to link the application as 
well as the object class to be able to call 
MyPrintFunction. Once there, a call to the 
function will resolve to your DLL and 
you can print without the overhead of 
another process or session—just a 
function call from your object class 
into some shareable application code. 


In a DLL, you write functions. It is 
not an executable program per se, but 
a library that contains functions and is 
callable by multiple processes. It is in 
this DLL that you can write the print 
handler It will have one externalized 
entry point, such as My Print Function. In 
this function you can accept the print 
destination structure you received 


from the wpPrintObject call, also with 
the real file name you received from 
ypQueryRealNane in the iipPrintQbject 
override in your class. This function 
will be called either from the applica¬ 
tion if it is running or from the object 
class that represents your data files. 
This is the consistent interface to your 
print function. 

Inside this function, you will cre¬ 
ate the printer device context and pre¬ 
sentation space using the print destina¬ 
tion structure provided, pull in the 
data file, interpret it, and draw it to the 
presentation space. You also have the 
option of calling DevPostOeviceHodes for 
the printer to offer the user the option 
of changing some of the printer de¬ 
faults. 

Since this is your program, you 
can write it to interpret the data file 
format and work with it. You could 
also do this in the object class, but why 
have the code in the application and 
the object class, too? If you make a 
change to one, you must also change 
the other. Dual maintenance is some¬ 
thing we try to avoid. 

To enable all of this, simply export 
MyPrintFunction from the DLL, and cre¬ 
ate a .LIB file for the DLL. You will use 


WHAT ABOUT THREADS? 

I'm sure by this time you/re asking 
about threads. This is especially im¬ 
portant when using this method of 
printing as opposed to doing it in the 
application, because when printing 
from the object using drag and drop, 
you are executing MyPrintFunction in the 
Workplace Shell's process, and, hence, 
using its threads. If you sim¬ 
ply had single-threaded 
code in your application, 
shame on you. 1/ you use the 
shell's thread and hold it for 
the duration of the print job, 
double-shame on you. 

You could start a thread 
in the application before you 
call MyPrintFunction and just 
call it on this new thread, 
and you could do the same 
in the object class you write. 
This solves the problem. 
However, it again gives you 
double code. It would be 
easier and more efficient to call 
BosCreateThread right inside MyPrint¬ 
Function. You could then immediately 
return control to your caller and pro¬ 
cess the printing on this new thread. 

Using this method, you create a 
thread only in one place and have only 
one set of code to maintain and debug. 
If you decide to write more applica¬ 
tions, you can use this utility, or per¬ 
sonal print library in all of them with¬ 
out having to code extra thread 
creation or other overhead each time. 

FINE TUNING 

There is one other bit of fine tuning 1 
need to touch on before you begin 
writing the code to exploit these fea¬ 
tures. This should also give you some 
food for thought when you write any¬ 
thing to do with DLLs. Go back a little 
bit and reread the part about the ,LIB 
files for your DLL. Notice anything in¬ 
teresting there? 

Recall the fact about DLLs that 
have functions that other programs 
use and import by name using the .LIB 
hie. The fix-up record in the executable 
code or other DLL is stored in the 
header of the EXE or DLL. Because 
when that module loads, the fix-ups 


You must be aware of the 
effects you have on the 
rest of the user's com¬ 
puter when you add your 
code to the system. 
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must be performed. If you call 
MyPrintFunction by name in your object 
class, then whenever an object belong¬ 
ing to your class is opened (which will 
hopefully be often since you will not 
only write the class for printing, but 
for full object-oriented function with 
the application) the print DLL will be 
referenced and loaded if it is not al¬ 
ready. This is more overhead than you 
need, especially if the user has no in¬ 
tention of printing the data object. 

The function can be called by ad¬ 
dress, using DosLoadModule and rather 
than by name. By using this method, 
you delay loading the code until you 
really need it, rather than loading it 
just because the module that refer¬ 
ences it has been loaded. 

There is nothing wrong with call¬ 
ing it by name and linking with the 
.LIB file when it comes to the applica¬ 
tion {if you still want to provide the 
user a File, Print menu option), but 
there's no reason to have the 
Workplace Shell load your DLL just 
because your document object class 
has been instantiated. These are the 
things you need to think about in cod¬ 
ing this advanced function and how to 
gracefully cooperate with the system 
functions. 

So, you've now seen a really con¬ 
crete example of using DLLs for more 
than just sharing code among pro¬ 
cesses of your own application. This is 
just the tip of the iceberg in what you 
can do with the functions provided by 
OS/2. As you saw in the final tuning 
and thread tips, you must also take 
care in how you use the system re¬ 
sources and be aware of the effects you 
have on the rest of the user's computer 
when you add your code to the sys¬ 
tem. That is just what you will be 
doing in the new "seamless" world: 
making your application a part of the 
user's computer, not just something to 
start, stop, feed, and maintain. 


David Reich has been with the IBM OS/2 
development team since 1987, He has worked 
on many parts of the system , supported cus¬ 
tomers and application developers, and trav¬ 
eled the world giving seminars and teaching 
OS/2. His latest hook is Designing High 
Performance OS/2 Warp Applications, pub¬ 
lished by John Wiley and Sons: He can be 
reached on CompuServe at 76711,632 or via the 
Internet at speedracer@bocaraton. ibm . com. 
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dient/Server Development 


During a client/server migration, there comes a time when you turn over the computers 
to your users and say "Go." Here's how to have a successful rollout. 

By STEVE KRANTZ 


Client/Server 
Migration—The 


Office Client Rollout 




Steiv Krantz 


This article is excerpted from Steve 
Krantz’s new book. Real World 
Client/Server, which details a major 
mainframe-to-client/server downsiz- 
mg project at IBM. ISBN 0-9633214- 
7A, IBM GA23-1216. Reprinted with 
permission, Maximum Press. Copies 
may be ordered via phone (800) 989- 
6733) or fax (615) 254-2408). 


fter all of the planning for a cli- 
ent/server migration is complete, 
there comes a point when you actu¬ 
ally give the users some computers and say 
go. This is the office client rollout. Careful 
planning must be performed prior to and 
during an office client rollout to guarantee 
user satisfaction. This article details the IBM 
Boca Raton, FI. experience during a large- 
scale client/server migration in 1993-1994. It 
will focus on the office client rollout, detail¬ 
ing requirements, the transition to client/ 
server computing, and some critical success 
factors. Although this focuses on the Boca 
experience, most of the activities can be gen¬ 
eralized and applied to your client rollout. 

The office client probably impacts the 
bulk of the users and should receive the 
greatest attention throughout any client/ 
server migration project. In Boca, over 2,700 
computer systems fit this category. An office 
client is a PC with e-mail, calendar, phone 
directory, network connectivity software, 
and, optionally, word processing, spread¬ 
sheet, and business graphics applications in¬ 
stalled in an office. 

Within the client/server paradigm, the 
industry-standard PC is a generally accepted 
platform for the office client. As the office 
client will be used by most, if not all, office 
workers, professionals, and managers in a 
business, understanding its requirements is 
very important. Basic requirements for an of¬ 
fice client are illustrated in Figure 1. Let's ex¬ 
amine each element in the figure: 

1. Industry-standard PC system. The sys¬ 
tem must contain adequate memory and 
disk storage to support the selected oper¬ 
ating system and applications. An Intel 
80486 processor operating at 33 MHz or 
higher, 8 to 16 megabytes (MB) of memory 
and a 200-MB hard disk should be consid¬ 


ered a typical configuration for a full-func¬ 
tion office client. 

2. A color graphics monitor capable of 
supporting from 640 by 480 (VGA) to 
1,024 by 768 (XGA, SVGA) graphics reso¬ 
lution. This is a widely supported indus¬ 
try standard, adequate for most user ap¬ 
plications. Fifteen-inch diagonal screen 
size and noninterlaced image support are 
optional requirements. 

3. A robust, multitasking operating sys¬ 
tem, able to support a broad range of of¬ 
fice and nonoffice applications with good 
performance. 

4. A Graphic User Interface (GUI), that 
has consistent human factors and a good 
performance. 

5. Network connectivity able to provide 
adequate bandwidth for all office applica¬ 
tions. This should be a 16-Mbps token¬ 
ring or 10-Mbps Ethernet LAN adapter for 
starters. 

6. Peripherals support may be a require¬ 
ment for a subset of users. Typical periph¬ 
erals requiring support include CD-ROM 
(internal) or a personal laser printer. Some 
users requiring multimedia support may 
require a sound card with stereo speakers 
or a video card to display video clips. 

USER INTERFACE 

A user interface is a general term for the 
way the user interacts with a computer sys¬ 
tem to get it to perform useful work. 
Consistency and user-friendliness were the 
key user interface requirements during the 
migration period. A common GUI was the 
obvious choice as provided by OS/2 
Presentation Manager. It offered a flexible 
windows application environment with 
consistent controls and rich customization 
capabilities. 
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OPERATING SYSTEM 

It is important to select a single operating 
system for the office client that meets your 
requirements. If it is designed well, it will 
support multiple applications efficiently, al¬ 
lowing them to share the client system hard¬ 
ware resources (such as processor, memory, 
and input/output devices) without error or 
conflict. It should support the broadest set of 
industry-standard applications to give you 
the broadest latitude in application selection. 
It is also a complicated piece of software that 
requires occasional service-bug fixes, up¬ 
grades for new features or releases, or cus^ 
tomization for new applications or system 
hardware. When a single operating system is 
selected, fewer support staff are required to 
assist users. Standardized maintenance pro¬ 
cedures can be created, thereby minimizing 
cost. 

From all angles, OS/2 was the best 
choice as Boca's standard client operating 
system. It is a robust, 32-bit, true multitask¬ 
ing software system that supports most of 
the PC-based applications available, includ¬ 
ing DOS, Windows, and OS/2 applications. 
Over two-thirds of the users were OS/2 lit¬ 
erate and had early versions installed al¬ 
ready. Not the least significant in the selec¬ 
tion was that IBM Boca Raton is the home of 
OS/2 development. This led to key advan¬ 
tages in support, quality, and (most impor¬ 
tant) acceptance. 

OS/2 provides an industrial-strength 
base for client/server migration. It is a fully 
architected operating system with an ad¬ 
vanced object-oriented user interface avail¬ 
able. In addition, OS/2 has crash and appli¬ 
cation protection. 

HARDWARE 

Selecting industry-standard hardware sim¬ 
plifies upgrades and maintenance. The 
broadest array of hardware upgrade and pe¬ 
ripheral products are available. Since Boca 
Raton was the home of the IBM PC Co., al¬ 
most all of the PCs were to be either IBM 
PS/2 or PS/ValuePoint systems. 

One mistake that was made was allow¬ 
ing individual departments too much leeway 
in ordering specific PC systems. The diver¬ 
sity of systems, even within a single depart¬ 
ment, added difficulty to the PC manufactur¬ 
ing process. 

The Intel 80486DX, operating at 33 MHz 
{million cycles per second) and with 16 MB 


of RAM (random access memory), was se¬ 
lected as the minimally capable processor 
complex based on informal benchmark test¬ 
ing performed in 1993. The bottom line was 
that application performance was too slow 
without this processor-memory combination. 
The minimum disk storage capacity of 240 
MB was selected based on two factors. First, 
the standard applications plus utilities took 
up approximately 160 MB of disk storage, so 
a reasonable additional amount needed to be 
available for data and other applications. 
Second, several models in PC Co. inventory 
offered a 240-MB hard file. 

Hard disks were logically partitioned in 
a standard manner (a physical disk is said to 
be logically partitioned when the operating 
system treats it as more than one disk, each 
with its own drive letter). The disk partition¬ 
ing was based upon practical experience with 
PC-operating systems. A 100-MB space was 
allocated to the C drive to contain operating- 
system-related code. This included OS/2, 
IBM Communications Manager/2, LAN 
Requester, DOS Dual Boot, and LAN Station 
Manager. Isolating the operating system and 
its utilities into its own logical drive enabled 
update or replacement of this code with min¬ 
imal impact to any user applications. 

A VGA CRT display, with 640 by 480 
resolution and up to 256 simultaneous col¬ 
ors, was deemed adequate graphics display 
resolution for the office client, although 
many systems were equipped with either 
XGA or SVGA resolution. 

The standard applications used the 
NetBIOS protocol for local LAN commumca- 
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Figure 7. Typical office client. 


NOVEMBER/DECEMBER 19 9 5 


25 

















a 




Ojrtcnef 
Com miriastfon iH 


Ojrtxfi« 

Oommuriiartcn M2 


Create TCP/IP 


Quasfiornsr® 

Hareteitf 

Sc#Vw 

ReqUrararte 

Nha-wU^kN 


PtioHntinn 


Create Lotus Incites 
&Ne*Door IPs 


£ 


CcrfpgLTe 


Run Plcrt 


Rrwfce 

ConiquMcf 




i 

8 

| 

1 

1 

n 

f 

07 

X 

0} 

£ 


=1 

i 

i 

l 

CD 

_ 

O 



I nve ntcry to hddinq Area 


Ordbr ictus Kbtes Licenses 


Tiack Haiduare Pet^eiy & Validate Rqmte 


f/gwre 2 IBM Boca Raton office client rollout process flow. 


tion, Some of the utilities used TCP/IP 
for both LAN and WAN communica¬ 
tion. SNA, IBM's standard mainframe 
network architecture, was used for ter¬ 
minal emulation communication from 
PC to mainframe. The site network 
supported these multiple protocols 
transparently, as all the LAN internet¬ 
works were connected using bridges, 
which do not see the differences in the 
higher-level protocols. 

The standard hardware interface 
to the site network was a token-ring 
adapter card, operating at 16 Mbps, 
All existing site PCs and workstations 
were already equipped with these 
adapter cards, and the site network 
was already operating at the 16-Mbps 
speed. 

The most common peripheral in 
user offices was a personal printer, ei¬ 
ther a dot matrix or a laser printer. 
Host-attached laser printers supple¬ 
mented this capability. A migration to 
LAN-attached printing is underway at 
the present time. 

Some less common peripherals 
were CD-ROM drives and multimedia 
adapter cards (sound, video), which 
were increasing in number during the 
transition period. 

OFFICE CLIENTS ROLLING 
OFF THE ASSEMBL Y LINE 

Once you have selected your standard 
office client's software and hardware, 
you face the daunting task of upgrad¬ 


ing each user with the minimum sys¬ 
tem so that all can participate in the 
new environment. It requires a well- 
run team of trained specialists working 
closely with users and other support 
teams. For a large rollout, assembly 
line processes are called for to achieve 
success. 

In January 1994 in Boca, over 
2,700 office client PCs were to be either 
upgraded or replaced by the end of the 
third quarter of 1994 by the Client 
Rollout Team. Approximately, 700 sys¬ 
tems were completed in 1993, so just 
over 2,000 remained in 1994. This 
meant that the target of installations in 
1994 had to average 50 systems per 
week (or roughly 10 per working day) 
for the rollout to be successful. Based 
upon the inventory of installed PCs, 
the Client Rollout Team made the as¬ 
sumption that 70% of the systems were 
to be replacements (brand new sys¬ 
tems) and 30% were to be upgrades. 

The team started with the follow¬ 
ing general objectives, which are ap¬ 
plicable to any client rollout: 

1. Minimum disruption to user's 
current work. 

2. All standard software prein¬ 
stalled. 

3. Final software customization 
would occur in the user's office by 
trained installer 

4. Installation would take no more 
than four hours. 

5. All user data from current system 


would be migrated 
by the installer at 
time of installation. 

6. Up to three appli¬ 
cations from the 
former system 
would be migrated 
to the new system. 

7. Users must return 
old PCs that had 
been replaced. The 
returned systems 
were to be reused 
or scrapped. 

Your approach to 
client installation or 
upgrade should be 
comprehensive. It 
should be based on 
the Golden Rule (Do 
unto others as you 
would have others do 
unto you), because 
each office client up¬ 
grade has a signifi¬ 
cant psychological, 
intellectual, and phy¬ 
sical impact on a new 
user. This was the approach used in 
Boca. 

The Boca process was comprehen¬ 
sive and included the following steps: 

1. Department focal points were 
identified to handle early informa¬ 
tion gathering and keep department 
members informed. 

2. Area meeting presentations were 
performed to set expectations and 
communicate the plan, 

3. Completion of a comprehensive 
user questionnaire, to establish user 
PC requirements, was required of 
every user. 

4. Hard disks of new PCs were per¬ 
sonalized with software through 
replication over the network from a 
"custom" master disk, which was 
for the department. 

5. Personalized PC replacements or 
upgrades were carefully scheduled. 
This included installation of the stan¬ 
dard desktop and maintenance of all 
prior capabilities (VM access, print, 
and up to three PC applications). 

To support this ambitious effort, 
the Client Rollout Team set up a pri¬ 
vate local area network. It was used to 
efficiently transfer disk images of the 
standard applications software suite to 
fully configured PC systems. 

The assignment of user focal 
points is highly recommended for 
your rollout. The focal point should be 
a person in each area or department to 
serve as your local agent to communi- 


26 


OS/2 DEVELOPER 












































































Manufacturing Process 
New Builds 



Figure 3. Manufacturing process—new builds. 

cate directly with each person to re¬ 
ceive a new or upgraded PC* The goal 
should be to have a focal point in each 
department (10 to 20 clients)* At the 
IBM Boca Raton site, this proved to be 
unrealistic. A few organizations with 
100 to 200 clients had assigned only a 
single individual to serve them. In ad¬ 
dition, this was a part-time responsi¬ 
bility for the majority of the focal 
points. The focal point key duties 
should be: 

1. Ensure completion of client ques¬ 
tionnaires. The questionnaire should 
be taken online by most clients. It 
gathers comprehensive information 
of client requirements. Appendix D 
includes a sample copy. 

2. Order network identifiers and key 
software licenses. At IBM Boca 
Raton, the Client Rollout Team or¬ 
dered TCP/IP identifiers and Lotus 
Notes licenses for clients. 

3. Track new PC orders and gather 
data on PCs to be upgraded. 

4. Communicate with the Client 
Rollout Team and the clients 
throughout the rollout period. A 
weekly meeting run by the team 
should review ail progress and 
problems. This proved to be a vital 
activity in IBM Boca Raton. 

A well-defined group-by-group 
rollout process should be initiated 
once a focal point is identified. In Boca, 
the Client Rollout Team defined an 
eight-week rollout process for each 
group* It was viewed as a week-by- 
week countdown, where week eight 
was the kickoff leading to week one's 
eventual in-office installation (Figure 


2). Week eight began with a presenta¬ 
tion to the users (Customer Commu¬ 
nication #1). This was an overview of 
the Client/Server Migration with spe¬ 
cific emphasis on the client rollout. 
Other activities initiated during week 
eight were creation of TCP/IP ad¬ 
dresses, ordering Lotus Notes licenses 
for each user, tracking of hardware de¬ 
liveries, and validating their accuracy 
vs. requirements. 

During week seven, emphasis was 
placed on completing user question¬ 
naires. As these were accu¬ 
mulated, user require¬ 
ments were solidified, in 
particular the breakdown 
of replacement PCs vs. PCs 
to be upgraded. This as¬ 
sessment was important in 
that it impacted installation 
resources* Through experi¬ 
ence, the Client Rollout 
Team learned that com¬ 
plete PC replacements took 
from two to four hours in 
the user's office, whereas 
upgrades took from five to 
twelve hours* The accumu- 
lated user requirements 
were prioritized along with 
available inventory, as 
well. This resulted in trans¬ 
ference of inventory meet¬ 
ing those requirements to a 
holding area aw T aiting final 
customization. 

By week six, the user 
group's requirements were 
sufficiently solid to enable 
initiation of a pilot master 



Figure 4. Office clients ready to go. 


build—the creation of a master hard 
disk to undergo testing during weeks 
five through two. 

In week five, the Server Admini¬ 
stration team created Lotus Notes and 
NetDoor identifiers for each user* 
These identifiers allowed users to ac¬ 
cess the applications. 

In week three, each customer was 
contacted individually to set up a re¬ 
placement or upgrade appointment. 
After the appointment was made, care¬ 
ful follow-up with the user was the 
rule to minimize no-shows. 

At week two, the master hard disk 
configurations for an area were final¬ 
ized* They included the standard ap¬ 
plications plus any unique area re¬ 
quirements. Unique area requirements 
were specific applications that an area 
needed to do its job. For example, all 
OS/2 developers required an applica¬ 
tion which linked them to their soft¬ 
ware code library and problem-track¬ 
ing database. 


Client 
Rollout. 
Team 



Figure 5, Manufacturing process—upgrades (original process). 
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During week one, the PC manu¬ 
facturing process began. Figure 3 de¬ 
tails the manufacturing process for 
new builds and identifies the staffing 
employed* Figure 4 shows a set of 
client systems ready to be delivered* 
The last step completed the manufac¬ 
turing process with the in-office instal¬ 
lation* Typical in-office installation 
time for new systems was two to four 
hours* 

Figure 5 details the original manu¬ 
facturing process for upgrades, which 
was completed entirely in the user's 
office. However, due to the variability 
of results with this method (from five 
to twelve hours), it was enhanced in 
June 1994 to combine in-office and 
manufacturing line sections (Figure 6), 

Deliveries of new PCs or up¬ 
grades to existing ones received the 
personalized attention of a trained 
and skilled installer. The installers 
were contractors, specially trained to 
perform the installation or upgrade 
function. Every effort was made to 
provide same-day functionality for all 
user PC requirements. A complete in¬ 
formation package was provided with 
the installation to answer most, if not 
all questions. 

Up to three personal applications 
were migrated to new PCs by the in¬ 
staller, provided proof of license was 
presented and original diskettes were 
available. All old PC data were mi¬ 
grated to new PCs during the installa¬ 
tion as well. This was accomplished by 
copying the entire existing hard disk 


files to a backup server on the network 
at the beginning of the installation/up¬ 
grade process. After installation/up¬ 
grade, the reverse copy was performed 
to an OLDDATA directory on the new 
or upgraded PC* If a PC was replaced, 
the old system remained in the user's 
office for about two weeks, just in case 
it was needed if the new PC failed. At 
the end of two weeks, the PC Returns 
department, a site services group, re¬ 
claimed the old system for either sale 
to another IBM site or refurbishment 
and redeployment* 

The Lotus Notes application 
played a critical behind-the-scenes roll 
for the Client Manufacturing process. 
Eleven Notes databases were em¬ 
ployed, serving as information reposi¬ 
tories, workflow automation, and 
tracking applications* The Client 
Implementation Library Notes data¬ 
base contained procedure, process, 
and forms documents specific to the 
client rollout* The ISSC Document 
Library, another Notes database, con¬ 
tained general application installation 
procedure documents. The User 
Questionnaires were imported and 
maintained in a consolidated Notes 
database* (Imported means that the 
data required conversion to the Notes 
format. This was required because 
most users employed VM to complete 
the questionnaire.) The Master 
Configuration database contained de¬ 
scriptions of the hard file masters to be 
used by the Client Manufacturing 
process. Three Notes databases were 


used for client tracking and scheduling 
by the Installation Team. Three Notes 
databases were set up to inform users 
of their migration schedule, provide a 
migration checklist, and, most impor¬ 
tantly, track purchase orders for new 
equipment. 

The Boca eight-week client rollout 
process was highly successful. It can 
easily be generalized to apply to your 
client rollout. 

THE CHALLENGES OF A CLIENT ROLLOUT 
(KEEPING MURPHY AT BA Y) 

A client rollout is extremely challeng¬ 
ing and requires a highly synchro¬ 
nized "manufacturing" process, wor¬ 
thy of a case study in industrial 
engineering! Many things can go 
wrong, and will (according to Mur¬ 
phy's Law), unless careful planning is 
performed* Several elements require 
synchronization, including; 

* Gathering and logging customer 
data profiles and requirements* The 
comprehensive user questionnaires, 
when consolidated in a readily 
available database (for example, 
Lotus Notes), meet this requirement. 

* Inventory delivery, staging, and 
control. Hardware delivery sched¬ 
ules can be unpredictable* They can 
be minimized through flexibility in 
schedule management, establish¬ 
ment of a three- to four-week inven¬ 
tory of readily accessible hardware, 
and supported by a (Lotus Notes) 
tracking database. 

* Work-in-process management. 
WeU-laid-out processes (see Figures 
4 through 8) make the difference. 

* Technical requirements changes. 
This is inevitable, as software levels 
change or last minute user requests 
filter in* The rollout team must be 
flexible and responsive to properly 
handle these changes. 

* Workload balancing. The client in¬ 
stallation team must be well- 
trained and proficient in their tasks 
to accommodate workload balanc¬ 
ing. Installers should be PC-famil¬ 
iar at least, with application and 
some operating-system modifica¬ 
tion experience. 

* Network-based software installation 
delivery. This is critical technology 
for large-scale client migration. 

* Setting customer expectations* 
Customer expectation of each phase 
of the process should be appropri¬ 
ately set. A mass client migration 
takes a good deal of the "personal' 1 
out of a user's personal computer. 
This is increasingly inevitable as 



Figure 6 . Manufacturing process—upgrades (revisedprocess}. 
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client/server technology matures. 

• Scheduling with the user. This is a 
delicate matter. Problems can be 
minimized through use of the air¬ 
lines' method of overbooking (a key 
insight) and up-to-the-minute 
scheduling communication with the 
user. 

# Additional user visits. Installation 
problems requiring additional user 
visits by installers add schedule 
pressure. This can be minimized 
through the use of carefully docu¬ 
mented procedures and up-front 
testing by the installation team. The 
use of (Lotus Notes) tracking data¬ 
bases for sharing of information can 
help here. 

By the end of the third quarter of 
1994, the Boca Client Rollout Team 
rolled out over 2,000 new or upgraded 
PCs. They met the goal of over 2,700 
enabled PCs delivered to the users. 

CRITICAL SUCCESS FACTORS 

The office client rollout is the heart of 
any client/server migration. Following 
are some key recommendations that 
will lead you to success in this critical 
phase: 

• You should carefully identify the 
minimum hardware requirements 
for client PCs. This should be based 
upon performance evaluations of se¬ 
lected applications on a real system. 
Ensure that processor, memory, and 
disk storage can be upgraded if re¬ 
quired. Secondarily, allow installa¬ 
tion of peripherals as upgrades. 

* There is no substitute for a complete 
inventory database of all user 
clients. This is required initially to 
scope the investment necessary to 
migrate to a client/server environ¬ 
ment. It is required on an ongoing 
basis in order to track asset owner¬ 
ship and identify upgrade candi¬ 
dates. Investing in automatic client 
inventory maintenance is very 
worthwhile. 
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• You should create a completely de¬ 
fined process for a large-scale client 
PC rollout. This should include 
user communication (gaining buy- 
in, setting expectations), installa¬ 
tion logistics, and tools. Flexibility 
in scheduling is also critical. 
Through careful schedule manage¬ 
ment and overbooking client PC in¬ 
stallations, your rollout team can 
achieve success. 

* Invest in groupware, gToupware, 
groupware. The use of Lotus Notes 
databases enabled the incremental 


improvements made by the Boca 
client rollout team in their process. 
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Client/Server Development 

Writing a server from scratch using interprocess communications can be challenging. 
Here's an example that works. 

By MICHAEL J. BARILLIER 


OS/2 Server Design 
Using Named Pipes 


C utting-edge technology in cli¬ 
ent/server computing today would 
appear to be independent applica¬ 
tions accessing a remote database. Scan 
through any computer-related magazine 
and count the number of database advertise¬ 
ments that do not include the term 
"client/server" somewhere in the text (from 
personal experience, this number should be 
very small). 

Despite what the DBMS software devel¬ 
opers claim, a database is nothing more than 
a resource, like memory or disk space, not an 
application server. While an application-to- 
DB server topology may be easy to imple¬ 
ment, system data storage is left wide open 
to all clients, preventing any data hiding or 
encapsulation. All rules concerning the stor¬ 
age of the system's data must be built into 
each client, resulting in development and 
maintenance headaches. (While a database 
may start out normalized, it generally falls 
victim to entropy over time.) A server 
should be more than just a data repository— 
it should provide services and statistics, 
exert intelligent control over clients con¬ 
nected to it, and interact with clients in con¬ 
cepts relevant to the system, not just raw 
rows and columns. If a billing system is 
being implemented, transactions should con¬ 
sist of customer and invoice objects, not 
VARCHARs and INTEGERS. 

Building a server isn't a trivial task, 
however. Management-types, obsessed with 
project completion dates, aren't very recep¬ 
tive when a developer announces that 
he/she is going to write a server from 
scratch. "What's wrong with using a data¬ 
base server?" they ask. "After all, every air¬ 
line magazine article I've read on the subject 
says that's the way to go." Also, less-experi¬ 
enced programmers may be intimidated 


when faced with the challenge of inter¬ 
process communications. This article should 
help in two ways. First, it demonstrates basic 
server design and interprocess communica¬ 
tion, and second, the sample code in Listings 
1 through 4 can be gutted and used as a 
skeleton for many client/server environ¬ 
ments. 

SYSTEM OVERVIEW 

The example server, Tserver, supports multi¬ 
ple simultaneous connections through 
named pipes. (The source code for Tserver is 
available on CompuServe in OS2DF2 as 
TSRVR.ZIP.) Many interprocess communica¬ 
tions methods are available under OS/2 such 
as shared memory, named pipes, APPC and 
APPN, TCP/IP, IPX/SPX, NetBIOS and RS- 
232, to name a few. The only methods avail¬ 
able on an out-of-the-box system, however, 
are shared memory, named pipes, and 
async. Of these, only named pipes is useful 
for interprocess communications between 
applications running either on the same 
workstation or on separate workstations. 
Client interaction with the server can be im¬ 
plemented using a simple fopen/fputs/ 
fgets/fclose sequence. Also, named pipes can 
be accessed by DOS and Windows applica¬ 
tions, given the proper software support, 
which means that the server can take advan¬ 
tage of OS/2's multitasking, crash protec¬ 
tion, and system resources while serving 
clients running on lesser operating systems 
(yes, I am an OS/2 bigot). 

Interaction between Tserver and clients 
is \n-terminated ASCII text messages, rather 
than the binary packets traditionally used in 
client/server communication. For example, 
if Tserver is sent the command string, 

TIME 
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the client would receive something like 
OK 13:21:05 

I've found that text-based communica¬ 
tions makes the server incredibly easy to ac¬ 
cess and test. One system that I built needed 
to have multiple clients simultaneously 
making different requests to stress test the 
system. Rather than write C applications, I 
wrote the clients in a few minutes in REXX, 
using lineout and linein to access the server. 
(More on client design later.) 

SERVER DESIGN 

Tserver is written as a multithreaded, VIG- 
based application. In ter thread communica¬ 
tion is through homemade message queues. 
These queues are simple singly linked lists 
with a mutex semaphore and an event sema¬ 
phore to provide access serialization and 
message availability notification, 

mainQ. The primary application thread 
is responsible for installing a break handler, 
starting the subthreads, dispatching mes¬ 
sages between the threads, and updating the 
application's output, which consists of the 
current time and, whenever an interesting 
event occurs within the server, a descriptive 
text message. The message processing loop 
ends when a breakhit message (as posted by 
the break handler) is pulled from the main 
message queue. 

Connect thread. The first thread started 
by the primary thread is the connect thread, 
which waits for clients to connect to an in¬ 
stance of Tserver's named pipe and posts 
the handle of the newly connected pipe to 
the main message queue. The function that 
implements this thread, connectthreadO, is 
pseudocoded in Listing 1. connectthreadO is 
loosely designed as a finite-state machine, 
with lots of labels and gotos, (While some 
programmers avoid gotos at all costs, com¬ 
munications applications in general are sig¬ 
nificantly simplified with their use.) 

In general, connectthreadO creates a 
named pipe, then waits on its shutdown 
semaphore for a short time. If not posted, 
connectthreadO checks the pipe for a connec¬ 
tion (the pipe is created in nonblocking 
mode). If a client has connected, the handle 
is passed to main() through mainO's message 
queue, a new instance of the pipe is created, 
and the loop starts over. 

Although DosCreateNPipeO includes an 



Listing L connectthreadO pseudocode. 
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instance count that may be unlimited, 
the number of iile handles available to 
an OS/2 process is limited by the 
FILES= statement in config.sys (the de¬ 
fault value is 20). To avoid this limita¬ 
tion, the FILES= statement can be 
changed, but this would be system¬ 
wide and a waste of resources. An al¬ 
ternative is to check for an ERR- 
ORJQOJIWr JPE^FILES return code from 
DosCreat^NPipeO, and when found, to 
call DosSstRelHaxFHO, incrementing the 
number of handles available. To keep 
the handle maximum from growing 
without limit, Tserver sets the pipe in¬ 
stance count in DosCreateNPipeO to a 
reasonable value. Once the maximum 
pipe instances have been created, 
OosCreateNPipeO will return ERR- 
OR_PIPE_BU$Y, and cormectthreadO will 
go back to waiting on the shutdown 
semaphore. 

Because the number of handles is 
limited, the number of simultaneously 
connected clients is also limited. 
Tserver's design is transact ion-based, 
so clients will not normally be con¬ 
nected for an extended amount of 
time. If the clients must keep their 
connections open for multiple transac¬ 
tions, and if a large number of clients 
exists, then the server design becomes 
more complicated. 

Client handler thread. The third 
thread in Tserver is the client handler 
thread. As clients connect to Tserver's 
named pipe, connectthreadO passes the 
handles to nainO, which in turn 
passes them on to clienthandlerthreadO 
through a message queue, clienthan- 
dlerthreadO, pseudocoded in Listing 2, 
maintains a linked list of clientinfo 
structures, each of which contains the 
handle of the pipe to the client and a 
buffer containing text received from 
the client but not yet terminated by a 
newline. 

New handles arriving in con¬ 
nected messages are packed into cli¬ 
entinfo structures and placed in the 
linked list. If a shotdounreq message is 
not received, then clienthancELerthreadO 
works through the list and appends 
any data waiting in the client's pipe to 
the command buffer for that client. 
The command buffer is parsed and 
any commands executed. A \n-termi- 
nated result string will always be re¬ 
turned to the client following com¬ 
mand execution, and the format of 
that string is dependent upon the 
command executed. The first token in 
the string will be "OK" or an error indi¬ 
cator such as "EBADCHD" or "EOFLOW". If 
the token is "OK", it will be followed by 



Listing 2 dienthandlerthreadO pseudocode. {Continued on page 33} 


any data resulting from the execution 
of the command, such as the current 
time for the time command. 

CLIENT IMPLEMENT A TION ISSUES 

At the client end, a named pipe acts 
just like a file, and a named pipe han- 
dle can be used in DostfriteO and 
DosReadf) calls just like any disk-based 
file handle. As mentioned before, a 
client can also access a named pipe 
using the C library file I/O function 
calls (for example, fopen, fputs, fgets). 
Listing 3 shows a series of calls to con¬ 
nect to Tserver and to request the cur¬ 
rent time using standard C file I/O 
{error handling has been omitted for 
simplicity). This example opens a lo¬ 
cally named pipe, \pipe\time, but to 
access a remote named pipe the only 
change required is to place the server 


workstation name in front of the pipe 
name, for example, \\app$rvr\pipe\tijne + 
Note the use of fflu$h() between the 
fputsO and fgetsO calls. The C $et++ 
documentation states that a file handle 
can be used for both reading and writ¬ 
ing, but a call to a file-positioning 
function, such as fseekO or fflushO, 
must be made between read and write 
operations. 

Access to a server using named 
pipes can be dropped into many dif¬ 
ferent types of clients. Both OS/2 VIO 
(windowed and full-screen text 
processes) and Presentation Manager 
applications can access this type of 
server, although a PM application de¬ 
sign should take into consideration in¬ 
terface responsiveness. Because server 
response time is generally unknown, 
the I/O sequence should not be placed 
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Listing 2 client ha ndlerthreadC) pseudocode, (Continued from page 32.) 


in the PM message processing thread 
to prevent the client program from 
locking up during these transactions* 
DOS and Windows applications can 
also access an OS/2 server using 
named pipes—1 have developed DOS 
applications that run on workstations 
connected using Novell LAN software 
with named pipe support, which ac¬ 
cess OS/2-based servers* 1 must 
admit, however, that I have not actu¬ 
ally written a Windows application 
that uses named pipes, but because 
Windows runs on top of DOS 
(Windows isn't a true operating sys¬ 
tem, remember?), I have to believe 
that this design is possible. 

Listing 4 shows an excerpt from 
gettime. cmd, which uses REXX to ac¬ 
cess the server, 1 generally use REXX 
clients when I want to knock out the 


client as quickly as possible, or I am 
building a client that performs some 
sort of background processing. 

ENHANCEMENTS 

Tserver is a very simple application, 
performing very few functions. What I 
consider the tougher part of the 
design—connection monitoring and 


char buffer[32]; 

FILE * f; 

f = f open("\\pipeV\time" ,"r+") ; 

fpots< ,, tiiie\n" l f); 

fflusb(f); 

fgetsf buffer, sizeof(buffer), f ); 
fdose(f); 

Listing 3, Accessing Tserver from C. 


client communications—can be used 
as is, so the largest part of the en¬ 
hancement process will probably con¬ 
sist of modifying Tserver's command 
parser. The parser used within Tserver 
does nothing but use stricmpO to 
check the first word of the command 
buffer for either "time" or "shutdown" * A 
better solution would be to use an 
LALR parser, such as the code gener¬ 
ated by Lex and YACC. Not only is 
the processing more efficient for large 
command sets or complex grammars, 
but the code will be far easier to main¬ 
tain and expand. 

Commands received by client- 
handler thread () are processed sequen¬ 
tially. Because of this, a command 
from a client, which takes a long time 
to process, will cause clients further 
down the list to wait. One solution to 
this problem is to use a worker thread 
pool. Once a \n-terminated command 
is detected, clienthandlerthreadQ 
would pull the clientinfo structure 
from the list, post it to the worker 
pool for processing, and then con¬ 
tinue handling input from other 
clients. If there are waiting worker 
threads in the pool, the message 
would be posted to the waiting thread 
for immediate processing* If there are 
no waiting threads and the maximum 
number of threads has not been 
reached, then a new worker thread 
would be created. If the maximum 
number of threads had been created 
and all were busy, the command 
would be queued* The worker threads 
would check the queue when their as¬ 
signed processing was completed. If 
no command was pending, they 
would go to a waiting state for an in¬ 
ternally specified time and exit if no 
message was posted during that time. 
This avoids having threads wait for 
work when nothing has been avail¬ 
able for a while. Once the worker 
thread completes its processing, the 




Listing 4. Accessing Tserver from REXX. 
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clientinfo structure would be re¬ 
turned to clienthaodItrthread() and re¬ 
inserted into the linked list. 

And finally—a database. Nowhere 
in the server design presented in this 
article has a database been required, 
nor have the clients needed to access 
data using SQL. If the server will be 
maintaining a large amount of data, 
then a database should be used inter¬ 
nally to facilitate its storage and access. 
However, the clients do not need di¬ 
rect access to the database, nor should 
they care whether the data is stored by 
the server in a true database, in flat 
files, or on stone tablets etched in 
Sanskrit* If, for some reason, the end 
users insist on using Query Manager, 
Paradox, or some similar product to 
build their own ad-hoc queries, then 
consider building a client support ap¬ 
plication to mirror system data to a 
separate user-accessible database. The 
clients can then build any query they 
like but will be unable to access the 
server's copy of the data and possibly 
crash the system. 

SUMMARY 

I had originally intended this article to 
be a soapbox tirade against the 
"client/server requires a database" 
philosophy, but decided instead that a 
viable alternative would be a better ar¬ 
gument than uncontrolled ranting. 
The design, used by Tserver, is not 
technically advanced but is useable in 
many applications where traditionally 
a remote database server would be 
used. If nothing else, I hope this article 
will get at least a couple of developers 
(and managers) to break out of the old 
mindset and use their own creativity 
and programming skills. 


Michael J* Bari Hi er is the heed of Rene¬ 
gade Digital Technologies, a software devel¬ 
opment and consulting company in St Louis , 
Mo He has been working with OS/2 since 
1989 and has extensive experience with 
client/server and object-oriented design . 
Bari flier can be reached via Internet at 
mjb@inlink.com. 
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When CORBA 
Objects Meet 
Transactions 


Client/Server Development 


An excerpt from Bob, Dan, and Jeri's latest book on client/server with distributed 
objects and components—including OpenDoc, CORBA, and OLE. 

By ROBERT ORFALI, DAN HARKEY, AND JERI EDWARDS 



r ransactions are essential for build¬ 
ing reliable distributed applications. 
So it should come as no surprise 
that transactions and distributed objects are 
getting married. The Object Management 
Group's (OMG) newly adopted Object 
Transaction Service (OTS) defines 1DL inter¬ 
faces that let multiple distributed objects on 
multiple CORBA ORBs participate in atomic 
transactions—even in the presence of cata¬ 
strophic failure* OTS optionally supports 
nested transactions- The support of nesting 
and inter-GRB transactions provides an ob¬ 
ject foundation for dealing with the complex 
world of multistep consumer-to-business 
and business-to-business transactions. 

THE CORBA OBJECT TRANSACTION SERVICE 

The Object Transaction Service (OTS) is pos¬ 
sibly the most important piece of middle¬ 
ware for distributed objects. OTS does a su- 



Figure 1 * The flat transaction: an all-or-nothing 
proposition. 


perb job of marrying transactions with ob¬ 
jects at the ORB level. With OTS, ORBs pro¬ 
vide a seamless environment for running 
mission-critical components* This feature 
alone gives ORBs a leg up over any compet¬ 
ing form of client/server middleware* An 
ORB becomes the next-generation TP 
Monitor. In this article, we first go over what 
makes transactions so important. Then we 
introduce OTS. 

WHAT IS A TRANSACTION? 

Transactions are more than just business 
events: They've become an application de¬ 
sign philosophy that guarantees robustness 
in distributed systems. In an ORB environ¬ 
ment, a transaction must be managed from 
its point of origin on the client, across one or 
more servers, and then back to the originat¬ 
ing client. When a transaction ends, all par¬ 
ties involved agree as to whether it suc¬ 
ceeded or failed* The transaction is the 
contract that binds the client to one or more 
servers. A transaction becomes the funda¬ 
mental unit of recovery, consistency, and 
concurrency in a distributed object system* 
Of course, all participating objects must ad¬ 
here to the transactional discipline; other¬ 
wise, a single faulty object can corrupt an 
entire system. In an ideal world, all distrib¬ 
uted object interactions will be based on 
transactions* 

Transaction models define when a trans¬ 
action starts, when it ends, and what the ap¬ 
propriate units of recovery are in case of fail¬ 
ure* The flat transaction model is the 
workhorse of the current generation of TP 
Monitors (and other transactional systems). It 
is called flat because all the work done within 
a transaction's boundaries is at the same 
level. The transaction starts with begin.trans- 
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action and ends with either a 
cornmit_transaction or abort,transaction 
(Figure 1)* It's an all or nothing propo¬ 
sition—there's no way to commit or 
abort parts of a flat transaction. 
However, the newer transaction mod¬ 
els—for example, nested transactions— 
provide a much finer granularity of 
control over the different threads that 


constitute a transaction. The newer 
transaction models are attractive be¬ 
cause they have the potential to better 
mirror their real world counterparts. 

OBJECT TRANSACTION 
SERVICE: FEATURES 

CORBA's OTS provides the following 
features: 


* Supports flat and nested transactions , 
All OTS implementations must sup¬ 
port flat transactions; nested trans¬ 
action support is optional. In a 
nested environment, the flat transac¬ 
tion is the top-level transaction. 

* Allows both ORB and non-ORB appli¬ 
cations to participate in the same trans¬ 
action. OTS lets you interoperate ob¬ 
ject transactions with procedural 
transactions that adhere to the 
X/Open DTP standard. 

* Supports transactions that span across 
heterogeneous ORBs . Objects on mul¬ 
tiple ORBs can participate in a sin¬ 
gle transaction. In addition, a single 
ORB can support multiple transac¬ 
tion services. 

* Supports existing IDL interfaces. A 
single interface supports both trans¬ 
actional and nontransactional imple¬ 
mentations. To make an object 
transactional, you use an ordinary 
interface that inherits from an ab¬ 
stract OTS class. This approach 
avoids a combination explosion of 
IDL variants that differ only in their 
transaction characteristics. 

OTS is a well-designed, low-over- 
head service that should perform at 
least as well as an X/Open-compliant 
procedural transaction service. 

THE ELEMENTS OF THE OBJECT 
TRANSACTION SERVICE 

Figure 3 shows the elements of OTS. 
Objects involved in a transaction can 
assume one of three roles: Trans¬ 
actional Clients, Transactional Servers, 
or Recoverable Servers. Let's go over 
these roles and see what they each do. 

* A transactional client issues a set of 
method invocations that are brack¬ 
eted by begin/end transaction de¬ 
marcations. The calls within the 
bracket may be for both transac¬ 
tional and nontransactional objects. 
The ORB intercepts the begin call 
and directs it to the transaction ser¬ 
vice, which establishes a transaction 
context associated with the client 
thread. The client then issues 
method invocations on remote ob¬ 
jects. The ORB implicitly tags the 
transaction context and propagates 
it in all subsequent communications 
among the participants in the trans¬ 
action. The ORB also gets involved 
when the client issues a commit or 
rollback and notifies the transaction 
service. The client is oblivious to all 
this under-the-cover activity; it sim¬ 
ply starts a transaction, issues its 
method invocations, and commits or 
rolls back the transaction. 


What's a Nested Transaction? 

Most of the alternatives to the flat transaction are based on mechanisms that 
extend the flow of control beyond the linear unit of work. Two of the most obvious 
ways to extend the flow of control are by chaining units of work in linear sequences 
of "mini" transactions fthe chained transaction or Saga models) or by creating some 
kind of nested hierarchy of work (the nested transaction). 

Nested transactions provide the ability to define transactions within other trans¬ 
actions. They do this by breaking a transaction into hierarchies of "subtransactions," 
very much like a program is made up of procedures. The main transaction starts the 
subtransactions, which behave as dependent transactions. A subtransaction can also 
start its own subtransactions, making the entire structure very recursive. A subtrans¬ 
action's effects become permanent after it issues a local commit and all its ances¬ 
tors commit. If a parent transaction aborts, all its descended transactions abort— 
regardless of whether they issued local commits. 

Figure 2 shows e main transaction that starts nested transactions, which behave 
as dependent transactions. Each subtransaction can issue a commit or rollback for 
its designated pieces of work. When a subtransaction commits, its results are only 
accessible to the parent that spawned it. The main benefit of nesting is that a failure 
in a subtransaction can be trapped and retried using an alternative method, still 
allowing the main transaction to succeed. 



Figure 2. Nested transactions: one top-level transaction and many dependent 
subtransactions. 
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• A transactional server is a collection 
of one or more objects whose behav¬ 
ior is affected by the transaction but 
have no recoverable states or re¬ 
sources of their own. The ORB im¬ 
plicitly propagates the transaction's 
context whenever these objects call a 
recoverable resource. A transac- 
tional server does not participate in 
the completion of the transaction, 
but it can force the transaction to be 
rolled back. 

• A recoverable server is a collection of 
one or more objects whose data (or 
state) is affected by committing or 
rolling back a transaction. Re¬ 
coverable objects are transactional 
objects with resources to protect. 
Examples of recoverable resources 
are transactional files, queues, or 
databases. Recoverable objects use 
the register method invocation to 
tell the transaction service that a re¬ 
coverable resource has just joined 
the transaction whose context was 
propagated in the client call. In ad¬ 
dition, recoverable objects provide 
methods that are used by a transac¬ 
tion coordinator (the coordinator is 
the transaction service) to orches¬ 
trate an ORB-media ted, two-phase 
commit protocol. 

OTS is seamlessly integrated with 
the ORB mechanisms. It relies on the 
ORB to automatically propagate the 
transaction context. Notice that the 
scope of a transaction is defined by a 
transaction context that is shared by 
the participant objects. The transaction 
context is a pseudo-object that's main¬ 
tained by the ORB for each QRB-aware 
thread. The context is null when there 
is no transaction associated with a 
thread. The transaction service man¬ 
ages and propagates the transaction 
context with help from the ORB. 

OTS provides "IDL-ized" inter¬ 
faces for the objects that make up the 
transaction service. So it is possible for 
clients and transactional objects to get 
more intimately involved in the details 
of the transaction propagation via ex¬ 
plicit method invocations. However, 
most transactions will depend on the 
ORB to transparently do all the work 
using its built-in facilities. Fewer inter¬ 
ventions means better performance. 

THE OTS INTERFACES 

Figure 4 shows the four key interfaces 
of OTS; we left out the minor ones. 
Here is a brief description of what each 
of these interfaces do: 

• Current defines a CORE A pseudo¬ 
object, which makes it easy for 


clients to use OTS. Clients invoke 
begin and commit to start and end a 
transaction. The ORB will transpar¬ 
ently propagate the context of the 
pseudo-object to the transaction ser¬ 
vice and to all participants in the 
transaction. The context contains an 
ID that uniquely identifies the trans¬ 
action; it also contains status infor¬ 
mation. The client can invoke roll¬ 
back to abort the transaction. It can 
suspend the transaction to stop propa¬ 
gating the context with each mes¬ 
sage; it can resume it when it wants 
the context to be propagated. 
Get .control returns a Control object 
that you can use to directly interact 
with the transaction service—a re¬ 
coverable server typically invokes 
this method to obtain a reference to 
its transaction coordinator. A top- 
level transaction invokes set.timeout 
to define maximum elapsed time (in 
seconds) for its subtransactions to 
complete before it aborts them. 

• Coordinator is implemented by the 
transaction service. Recoverable ob¬ 
jects use it to coordinate their partic¬ 
ipation in a transaction with the 
OTS. A server invokes register, re¬ 
source to participate in a transaction. 
If it supports nested transactions, it 


instead invokes register.subtran.a- 
yare. It invokes create,subtransaction 
to create a nested transaction that's 
a child of the current transaction. It 
invokes rollback.only to abort the en¬ 
tire transaction. The get. and is. op¬ 
erations are useful to servers that 
need to explicitly control their par¬ 
ticipation in a transaction. The hash, 
operations return a handle to the 
current transaction. Before invoking 
register.resource, servers use the 
hashed value to find out if the cur¬ 
rent resource is already registered. 

• Resource is implemented by a re¬ 
coverable server object to participate 
in a two-phase commit protocol. 
OTS uses the two-phase commit 
protocol to coordinate a transac¬ 
tion's commit or abort across multi¬ 
ple server objects so that they either 
all fail or all succeed. To do this, 
OTS centralizes the decision to com¬ 
mit but gives each participant the 
right of veto. It's like a Christian 
wedding: You're given one last 
chance to back out of the transaction 
when you're at the altar. If none of 
the parties object, the marriage takes 
place. 

In the first phase of a commit, 
OTS invokes prepare on all the partic- 
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Figure 3: Object transaction service: meet the players. 
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Figure 4. Object transaction service: the key interfaces '. 


ipant resource objects. Each resource 
object returns in a parameter a 
"vote" value that is either vote,com¬ 
mit, vote,rollback, or vote,readonly. 
Based on the vote's outcome (every¬ 
one has veto power), the transaction 
service either issues commit or 
rollback. It can also issue a forget to a 
resource object that's fuzzy about its 
outcome. If the coordinator has only 
a single registered resource, it 
avoids the two-phase commit alto¬ 
gether and invokes commit_one_phase 
instead. 

* SubtransactionAwareResource is 

implemented by a recoverable server 
object with nested transaction behav¬ 
ior, This interface is derived from the 
Resource interface. It adds two new 
methods: commit_subtransaction and 
roHback_5ubtransaction. These meth¬ 
ods are invoked when subtransac¬ 
tions are complete. Subtransaction 
aware server objects must first regis¬ 
ter with the Coordinator object by in¬ 
voking register_subtran,aware. 

You should also be aware of the 
existence of a TransactionalObject in¬ 
terface. This is an abstract class that 
defines no operations* What is it good 


for? It's actually a very important 
class. It serves as a marker, which ob¬ 
jects use to indicate that they're trans¬ 
actional. To make your object transac¬ 
tional, you simply inherit from the 
TransactionalObject class* The ORB 
will then propagate the transaction 
context associated with a client's 
thread whenever the client invokes 
any method on your object. Note that 
the ORB passes this context in a special 
field (the context field) that is totally 
transparent as far you're concerned. 
It's something ORBs da implicitly, 

AN OBJECT TRANSACTION SCENARIO 

Are you getting overwhelmed with all 
these interfaces? We will explain how 
these interfaces are really used with an 
annotated scenario (too bad we can't 
animate an article)* Figure 5 shows a 
scenario of a client doing a debit 
against one server object and a credit 
against another one* The example is 
"get $100,000 dollars out of Jen's ac¬ 
count in Bank A and put it in your ac¬ 
count in Bank B," You don't want this 
to fail, do you? The objects represent¬ 
ing Bank Aand Bank B are recoverable 
server objects that multiply inherit 


from the Resource class and the 
TransactionalObject abstract class (re¬ 
member, this is the indicator that does 
nothing). We also show two transac¬ 
tion service objects that are instances 
of the Current and Coordinator 
classes. The client initiates this transac¬ 
tion across the two servers and issues a 
commit when it's done. Hopefully, the 
money will get tucked away safely in 
your account. Here's the explanation 
that goes along with the numbers in 
the picture: 

1* Client begins transaction* The 
client invokes begin on the Current 
pseudo-object. The ORB passes this in¬ 
formation to the transaction service 
that maintains a Current object for 
each active transaction. 

2. Client makes a debit on Bank 
A's object* The client invokes a debit 
method on an object in Bank A. This 
object implements the logic of the 
transaction (something you write), but 
it also inherits its behavior from the 
OTS classes Resource and Transac¬ 
tionalObject. So we're dealing with a 
recoverable resource object* 

3, Bank A's recoverable object reg¬ 
isters its resource. The recoverable 
server object first invokes the method 
get_control on the Current object (the 
shorthand notation is Current: :get„con- 
trol) to obtain a reference to the 
Coordinator object* Then it invokes 
Coo rdin a to r::r egis te r_ r e sou r ce to regis ter 
with the coordinator object for this 
transaction* The coordinator keeps 
track of all the participants. 

4* Client makes a credit on Bank 
B's object. The client invokes a credit 
method on an object in Bank B. This 
object implements the logic of the 
transaction (again, something you 
write) but also inherits its behavior 
from the OTS classes Resource and 
TransactionalObject, So we're dealing 
with a recoverable resource object, 

5. Bank B's recoverable object reg¬ 
isters its resource* It's a repeat of what 
Bank A's server just did* 

6. Client issues a commit. The client 
invokes the method Current:: commit* The 
ORB informs the transaction service 
that the transaction has ended* 

7. Coordinator performs phase 1 
of two-phase commit. The coordinator 
invokes each participant's prepare 
method to get a vote from all the par¬ 
ticipants on whether this transaction 
should be committed for posterity (that 
is, you get your $100,000), Let's give 
this scenario a happy ending by assum¬ 
ing everyone returns a "vote^commit ** 

8. Coordinator performs phase 2 

























































of two-phase commit. The coordinator 
tells all the participants to commit. 
You now have $100,000 more to spend 
in your bank account. 

Are you all feeling richer, or just 
tired? Tt would have been better for 
Jeri if the coordinator had issued a roll¬ 


back instead of a commit. She could 
have kept her $100,000. Luckily, our 
scenarios are only fiction. This happy 
ending concludes our OTS story. 

CONCLUSION 

In addition to being important at the 
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system level, OTS will redefine the 
way that we build our client/server 
middleware. For starters, it will en¬ 
courage developers to use transactions 
pervasively. Transactions are now part 
of the ORB. As a result, most objects 
that live on the ORB will be transac¬ 
tional. The ubiquitous use of transac¬ 
tions on the ORB will result in TP 
Monitors morphing into ORBs (or vice 
versa). This means that ORBs may 
very well be the next generation TP 
Monitor. 
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Client/Server Development 

Configuring DB2/2 for Novell's NetBIOS. 

By JEFFREY ALTMAN 


DB2 / 2 Communication 
Using Novell's 


NETBIOS Over IPX 


ast year, while working on the NET¬ 
BIOS interfaces in C-Kermit for OS/2 
communications software, I came 
across a friend who was having trouble in¬ 
stalling an IBM Database2 OS/2 1,2 
(DB2/2) server on a Novell Netware 3.11 
wide-area network of OS/2 and DOS work¬ 
stations. DB2/2 uses the NETBIOS Network 
application programming interface (API) to 
enable its servers to communicate with its 
clients on the DOS/Windows and OS/2 
platforms. The problem was that clients on 
different subnets could not communicate 
with the server. 

The OS/2 workstations were using IBM 
Multi-Protocol Transport Services (MPTS) 
and Novell Netware Requester 2.11 to pro¬ 
vide network access. The DOS workstations 
were using a combination of Novell's 
Netware Client Kit for DOS/Windows and 
IBM Network Transport Services for DOS 
(NTS/DOS), All of the systems were using 
IBM's implementation of NETBIOS for 
database network communication. 

In the years since its introduction in 
1984, NETBIOS has become a portable net¬ 
working interface that is independent of the 
underlying networking protocols (session 
and link layers). NETBIOS has been imple¬ 
mented on top of several protocols includ¬ 
ing, NETBEUI (the original protocol used in 
the IBM PC Network of the early '80s), IPX 
(the protocol used in Novell NetWare 
Networks), and IP (the protocol used on the 
Internet). 

The standard IBM implementation of 
NETBIOS uses the NETBEUI protocol. 
While this protocol is fast and easy to use, it 
does have several downsides. First, in¬ 
stalling a NETBEUI NETBIOS protocol on a 
DOS Netware client requires the purchase 
of additional software—NTS/DOS. Second, 


NETBIOS is implemented using a broadcast 
scheme, which requires that all packets be 
sent to all workstations, NETBEUI packets 
are not routable and, therefore, NETBEUI 
NETBIOS networks are difficult and expen¬ 
sive to configure on networks consisting of 
multiple subnets. 

Users of Novell Netware LANs have a 
wonderful alternative. They use NETBIOS 
over IPX instead of NETBIOS over NET¬ 
BEUI. IPX NETBIOS is included free of 
charge with the Netware Client Kits for 
both DOS/Windows and OS/2. By config¬ 
uring DB2/2 to use IPX NETBIOS instead of 
NETBEUI NETBIOS, installations with a 
large number of DOS/Windows clients on a 
multiple subnet Netware LAN can avoid 
the expense of purchasing IBM Network 
Transport Services for DOS (NTS/DOS) and 
conserve DOS real-mode memory. 

In addition, IPX packets are routable, 
thereby avoiding the requirement that NET¬ 
BIOS Name Tables be maintained on each 
LAN segment by the routing equipment in 
order for NETBIOS Name collisions not to 
occur. This maintenance of synchronizing 
multiple name tables would require more 
expensive routing equipment and increased 
LAN traffic. 

On DOS/Windows clients, all NET¬ 
BIOS implementations regardless of vendor 
and underlying protocol use the Int 5Ch 
and Int 2Ah software interrupts to interface 
between the application and the NETBIOS 
driver. This enables any application to use 
any vendor's NETBIOS. Substituting one 
NETBIOS implementation for another is 
therefore a trivial exercise. 

In OS/2, NETBIOS is implemented via 
an API stored in a DLL, Unlike DOS, OS/2 
currently has two different standard APIs 
for implementing NETBIOS: "NETBIOS 
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Submit" and "NETBIOS 3.0", This results in 
not every application being able to interface 
with every implementation of NETBIOS* 
DB2/2 was written to use the NETBIOS 
3.0 API provided in the IBM MPTS package* 
Even though Novell provides IPX NET¬ 
BIOS, it can't be used directly by DB2/2 be¬ 
cause it implements the NETBIOS Submit 
API* However, by installing both MPTS and 
NetWare Requester for OS/2 (NWR/2) on 
the workstation in a multiple-stack configu¬ 
ration, it is possible for DB2/2 to use the 
IPX NETBIOS services* 

THE NETBIOS 10 API STACK 

Under a normal installation of IBM MPTS, 
three NETBIOS-related files are installed: 
ACSNETB.DLL, NETBIGS.OS2, and NET- 
BEULOS2. The NETBIOS 3.0 API is imple¬ 
mented in ACSNETB.DLL. All programs 
that are developed to use the NB30 API 
must load this DLL at run time* NET¬ 
BIOS.OS2 provides a protocol-independent 
NETBIOS API called LM10. NETBEUI.OS2 
implements the Netbeui protocol, which is 
called by NETBIOS.OS2. The calling se¬ 
quence is shown in Listing 1. 

NOVELL'S NETBIOS SUBMIT API STACK 

The NETBIOS Submit API was originally 
developed as part of the IBM OS/2 
Extended Edition and then IBM OS/2 
Extended Services. NETBIOS Submit was 
just one of many communications APIs that 
were included in the original NETAPI.DLL. 
Novell adopted the NETBIOS Submit API 
and implemented its own version of NET- 
API.DLL with only NETBIOS support. 
Novell's NETAPLDLL depends heavily on 
another DLL, NETSUB.DLL, which actually 
implements the NETBIOS Submit calls* 
NETAPI.DLL is just a compatibility layer* 
NETSUB.DLL, in turn, communicates with 
Novell's NETBIOS.SYS. NETBIOS.SYS im¬ 
plements a NETBIOS protocol using the 
Novell IPX protocol* The calling sequence is 
shown in Listing 2* 

IMPLEMENTING MULTIPLE 
STACKS WITH LMW NETBIOS 

IBM's LM1G NETBIOS specification (NET- 
BI05.0S2) is protocol-independent and can 
implement NETBIOS interface across any 
protocol compatible with it* Novell's NET- 
SUB*DLL is programmed to look for NET- 
BIOS.052 prior to looking for NETBIOS.SYS. 


Therefore, when both products are installed 
on the same machine, calls to either NET¬ 
BIOS 3.0 or NETBIOS Submit interfaces 
would by default both share the IBM NET¬ 
BEUI protocol. 

NETBIOS.OS2 can be configured to rec- 



Listing 7* The IBM MPTS NETBIOS protocol stack. 



Listing Z The Novell Netware NETBIOS protocol stack: 



Listing 1 Multiple stack using IBM MPTS and Novell NETBIOS, 
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a Example 1: Both NETBEUI and IPX NETBIOS implementations and one physical adapter. IPX 
NETBIOS is the default. 

[NETBIOS] 

DriverName-NETBIOSl 
AdapterQ-ipxnbM 
Adapter!=netb«ulM 

Example 2: Both NETBEUI and IPX NETBIOS implementations and one physical adapter. 
NETBEUI NETBIOS is the default, 

[NETBIOS] 

Drill erNaifte-NETBIQ$$ 

AdapterO*netbeui$,() 

Adapt erl=4>xnb$,0 

Example 3: Only IPX NETBIOS Implementation and one physical adapter. 

[NETBIOS] 

0 riv er Narne-N ETBIQS$ 

#dapterO=ipxnb$ F 0 

Example 4: Both NETBEUI and IPX NETBIOS implementations and two physical adapters. 
NETBEUI NETBIOS is the default. Because IPX NETBIOS retrieves its configuration information 
from NET. CFG, instead of PROTOCOL ♦INI, it is not possible to specify a physical adapter 
binding other than Cl 

[NETBIOS] 

Dri v erNa«e=N ETBIOSt 
Adapter0=netbeui$,0 
Adapterl=ipjtnbJ,0 
Adapter2=netbeui$ >1 

Listing 4, Four examples of using more than one protocol simultaneously. 


ognize more than one protocol. This 
allows each application to choose the 
appropriate protocol at run-time re¬ 
gardless of which NETBIOS API it 
was written to use. This is known as 
implementing a multiple stack. After 
proper configuration, the multiple 
stack could look like Listing 3. 

NETBIOS.OS2 retrieves its con¬ 
figuration information from the PRO- 
TOCOL.INI file, which is stored in the 
IBMCOM directory created during 


the MPTS installation. PROTO¬ 
COL.INI consists of sections identi¬ 
fied by driver names in square brack¬ 
ets followed by configuration 
item-and-va!ue pairs indented from 
the left margin. Most of the settings in 
PROTOCOL.INI are configured by 
using MPTS.EXE. 

Without a configuration specified 
in PROTOCOL.INI, NETBIOS.OS2 
uses its default configuration to de¬ 
fine one Logical NETBIOS Adapter 
for each Physical Adapter 
Driver and bind NET- 
BEULOS2 to each of the 
logical adapters. 

This default configu¬ 
ration can be overridden 
by using a text editor, such 
as E.EXE, to add a (NET¬ 
BIOS] section to the end of 
the PROTOCOL.INI file. 
The format of this new sec¬ 
tion is: 

[NETBIOS] 

DriverName=NETBIOS$ 
<logical adapter>=<driver> t 
<physical adapter binding? 
[/sessions? [/commands? 
[/names?]]] 



Figure 7 DB2/2 workstation directory catalog. 


<logical adapter?*=<driver?, physical 
adapter binding? 

[/sessions? [/commands? [/names?]]] 

where: <Logieal adapter? is ADAPTERO 
through ADAPTER9. The logical 
adapter numbers must be in sequence. 

<driver> is the protocol-specific 
implementation of NETBIOS. For ex¬ 
ample, "ipxnb$" for Novell IPX, "net- 
beui$" for IBM NETBEUI, or "tcpbeuij" 
for IBM TCP/IP. 

<physical adapter binding? is the 
binding order of the physical adapter 
driver (that is, IBHTOK_nif NE2000_nif ) on 
the Bindings line in the NETBIOS 
<driver?'s (NETBEUI_nif or TCPBEUCnif) 
section in the PROTOCOL.INI file. 
This value may range from 0 to 63. 
However, it is usually 0, since there is 
rarely more than one physical adapter 
installed in the machine. When used 
with the IPX NETBIOS, this value 
must be 0 because the ipxnbS driver 
retrieves its configuration data from 
the Novell NET.CFG file and not 
PROTOCOLTNL 

<sessions> 1 Kcommands?, and <names? 
are optional parameters which place 
an upper limit on the number of ses¬ 
sion, commands, and names that may 
be used by the <driver?, These values, 
if specified, must be greater than or 
equal to the settings in NET,CFG 
(Netware NETBIOS section) if <driver? 
is ipxnb$, or PROTOCOL.INI (Net- 
beul_nif or Tcpbeui_nif sections) if <dri¬ 
ver? is either netbeuil ortcpbeuil. 

By assigning different NETBIOS 
implementations to different logical 
adapter numbers, it is possible to use 
more than one protocol simultane¬ 
ously. Four examples are shown in 
Listing 4. 

CONFIGURING IBM DBZ/2 TO USE 
MULTIPLE NETBIOS IMPLEMENTATIONS 

To enable DB2/2 and the DOS/ 
Windows Client to use multiple logical 
NETBIOS Adapters, you must add the 
following line to your CONFIG.SYS 
and DBDRQLIBXDBDRQLIB.CFG file: 

SET StJLNUOPTMLL 

This statement instructs DB/2 to ini¬ 
tialize or reset all NETBIOS adapters 
when it is started. Other valid values 
are 0, 1, or NONE. NONE tells IBM 
DB2/2 not to use NETBIOS at all, 
while 0 or 1 instructs it to use only 
that particular adapter. The default is 
0. DB2/2 can only access adapters 0 
and 1. Even though you can define 
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Config File 

Sessions 

Commands 

Names 

pxnbt 

MET,CFG 

16 

32 

24 

netbeuil 

protocol. m 

130 

254 

21 

tcpbeuiS 

PROTOCOL.INI 

130 

254 

21 


Table t The fault values of various NETBIOS settings. 



Config File 

Sessions 

Commands 

Names 

ipxnb$ 

NET.CFG 

64 

128 

128 

netbeuU 

PROTOCOL.INI 

254 

255 

254 

tcpbeuij 

PROTOCOL.INI 

254 

255 

254 


Table 2. Maximum values of various NETBIOS settings. 


adapters 2 and 3 to NETB10S.0S2, 
DB2/2 can not use them. 

To specify the number of client 
sessions that can be active simultane¬ 
ously on each NETBIOS adapter add 
the following line to CONFIG.SYS 
(DB2/2 Servers only): 

SET SQLNETB=xx,m 


an overhead of six sessions. Therefore, 
these values must be greater than or 
equal to six plus the number of clients 
that will attempt to maintain simulta¬ 
neous connections to the DB2/2 Server. 
If xx = 16, then the eleventh client that 
tries to connect to DB2/2 Server using 
the driver assigned to AdapterO will 
not be able to connect. 


where xx is the number of sessions for CATALOGING DB2/2 WORKSTATIONS 

Adapter 0 and yy is the number of ses- ON NETBIOS NETWORKS 

sions for Adapter 1. DB2/2 Server has NETBIOS workstations are defined 


Glossary 

IP Networking protocol used for communication on the Internet. 

IPX, Networking protocol used for communication between Novell 
Netware clients and servers. 

IMW . A protocol-independent NETBIOS programming interface at the 
device driver level. 

Logical adapter The NETBIOS API assumed that only one protocol 
could exist on a given network adapter card. Logical adapters are used 
to allow NETBIOS to distinguish between between unique combina¬ 
tions of protocols and physical adapters. 

NETBEUI, Networking protocol developed for single subnets LANs in 
the early J 8Gs. 

NETBIOS, A protocol-independent APL Available on all types of net¬ 
works and operating systems, NETBIOS enables software developers to 
create client/server applications without being concerned about the 
type of network the application is using for communication. 

Physical adapter binding A protocol driver may be bound to more 
than one network adapter card driver. The physical adapter binding 
value specifies which network adapter is being referred to in the bind¬ 
ing list. 


within DB2/2 by using the Directory 
Tool. Open the Workstation Directory 
and then choose Workstation Catalog 
(Figure 1). Choose a local name for 
the remote DB2/2 Server. Select a 
NETBIOS connection. Provide the 
NETBIOS name specified when the 
server was configured. Then, select 
the logical NETBIOS adapter upon 
which that server can be found. 
Remember, if the server is configured 
to use NETBEUI NETBIOS, a work¬ 
station configured to use IPX NET¬ 
BIOS will not be able to communicate 
with it. 



DB/2 NETBIOS RESOURCE 
REQUIREMENTS 

IBM DB2/2 requires the following re¬ 
sources from each NETBIOS protocol: 
4 names, 46 commands, and as many 
sessions as are specified in the SQL- 
NETB line in the CONFIG.SYS file. If 
these resources are not available 
when IBM DB2/2 is started, NETBIOS 
connections will not be available for 
that adapter. 

The number of commands, ses¬ 
sions, and names must be configured 
separately for each NETBIOS protocol 
stack. NETBEUI NETBIOS is config¬ 
ured using MPTS.EXB. IPX NETBIOS 
is configured by editing the NET.CFG 
file. {See appropriate documentation 
associated with each product for fur¬ 
ther details.) 

The default and maximum set¬ 
tings for various NETBIOS implemen¬ 
tations are illustrated in Tables 1 and 
2, Because Novell NETBIOS defaults 
to 32 commands, a "Netware NET¬ 
BIOS" section must be added to the 
NET.CFG file. In that section, a "com¬ 
mands" statement should be placed, 
which increases the number of com¬ 
mands to at least 46. 

NETBEUI NETBIOS should en¬ 
able DB2/2 to support a greater num¬ 
ber of sessions than IPX NETBIOS. 
But the maximum values, shown in 
Table 2, are pipe dreams. Due to 
memory constraints within the NET¬ 
BIOS driver, it is unlikely that the 
maximum values could ever be used. 

Listings 5, 6, and 7 provide ex¬ 
cerpts from the configuration files of a 
system that has implemented the 
techniques previously described. 

CONCLUSION 

Having successfully configured our 
NETBIOS implementation for use 
with IBM DB2/2, we have expanded 
the range of use of our client server 
Continued on page 45 
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SET SQLNETB-16 
SET SQLNlDPT-tLL 

LIBPITH*.. , D:\HPTN\[)LL;D:\I8MC0M\01L;... 

D:\NETWARE.2ii;L:\0S2;P:V0S2; 

SET PATH*,..D:\NPTN\BIM;D:\IB«C0M;... 

D:\NETWARE.211;L:\0S2;P:\DS2; 

SET DPITtK..D:\IBMC0M;,.. 

B:\NETVARE.I11;0:\NETWRE.211\HLSVENCLISH;L;\NLS;P:\HLS;. 
SET HELP*.. .D:\NETWRE.21\NLS\ENGLISH;... 

DEVICE=D:\IBNC0H\PROTOCOL\LANP0D.0S2 
DEVICES: \IBNCDR\PR0T0C0LUJ NV00.0S2 
DEVXCE=D:\IBPICDH\PROTM*N .052 /I:D:\IBMCQM 
DEVICES: \IBMCOM\LAHHSGDB .052 /I:D: \IBMC0M 
REM — NetWare Requester statements BEGUN — 

SET MVLINGI)iGE=ENGLISH 
DE»ICE=D:\NETMiRE.!ll\LSL.STS 
RUN-0:\NETWARE.211\DDAEMQN.EXE 
REM -- ODI-Driver Files BEGIN — 

DETICE=D:\IBNCOM\PROTOCOL\ODI2NDI.0S2 
REM - GDI-Driver files END - 
DE»ICE=D:\NETtf»RE.2U\IPI.STS 
&EHCE-D: \NETVARE.211\SPI.STS 
RGN*D:\METWRE.211\SPDAENDN. EXE 
DEVICE—D:\NETMARE.211\NHRXPE.STS 
BE VICE=0:\NETVARE.211\NPSERVER.St$ 

RUN=0:\NETWiRE.211\NPDAEM0N.EXE NPSERVERNAHE 

0E»ICE=0:\BETWIRE.211\NWREQ.STS 

XFS s 0:\NETVARE.211\NVIFS.IFS 

RUN=0:\NETWiRE.211\NWDIEMDN.EXE 

DE«ICE=D:\NETVARE.211\NETBIDS.STS 

RUN=0:\NETWARE,211\NB0AEM0N.EXE 

DEVICE=D:\0S2\H0DS\LPTDD.SYS 

REM — NetWare Requester statements END — 

RUN=O:\IBMC0M\LXNMSGEI.EXE 

DE VIC E=0:\IBMC0M\PR0T0CDL\LAN0D.0S2 

DEVICES: \IBNCOMVPROTOCQL\L1NDLLDD. 0S2 

TRACEB«F*16 

DEVICE=0:\IBNCDM\HiCS\IBMT0K.0S2 
RUN=D:\I8NC0N\PR0T0C0L\LANDLL.EXE 
DEVICES:\IBMCDM\PROTOCOLVNETBEUI.0S2 
DEVICES:\IBNCDM\PR0T0C0L\NETBI0S.0S2 
RIM: \IBMCOM\PROTOCQL\NETBIND .EXE 


this software and 
services directory of 
products for OS/2, 
ATX and other 
IBM supported 
operating systems. 


Sponsored by IBM\ OS/2 Developer, 

OS/2 Magazine, and Software Development, 

OS/2* is a registered trademark of Find It 

International Business Machines il t| fha 

Corporation and is used by Miller 
Freeman. Inc. under License. 


Listing S. Excerpts from sample CONFIG.SYS file after installation of Novell Netware Requester 

2.1 land IBM MPTS. 

tNETBEUI.nif] 


NETBIOSTIHEOUT - 500 



NETBIGSRETRIES « 8 

DriverName = netbeuiS 


NAMECACHE - 16 

Bindings * IBHTQK.nif 


PIGGfBACKICKS - 1 

ETHERANDJYPE ^ "I" 


DATAGRAHPACKETS = 2 

USEADORREY = "YES" 


PACKETS = 350 

DS2TRACEHASK = 0x0 


LQDPPACKETS = 1 

SESSIONS = 48 


PIPELINE = 5 

NCBS = 190 


HA A TRANSMITS = 6 

NAMES = 64 


HINTRANSMITS = 2 

SELECTORS = 16 


DLCRETRIES = 5 

USEMjI X DAT AGR AM = *»ES* 


FCPRIDRITY = S 

ADAPTRATE = 1000 

UXHDOWERRORS = 0 


NETFLAGS = 0x0 

MAADATARCV = 16304 

n - 30000 


[NETBIOS] 

T1 - 500 


Oriverfilame - NETBIOSS 

T2 * 200 


ADAPTER0 = netbeuiSjO 

nlXIN * 32 


ADAPTERl = ipxnbSiO 

Mi(OUT • M 




Web! Listing 6 , Sample [NETBIOS] and [NET8EU!_nif] sections from PROTOCOLJNl file. 
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database applications without in¬ 
creasing the burden on the network 


administrators or bearing additional 
software expense. 


It is important to note that the 
techniques used in this article to en¬ 
able DB2/2 to use IPX NETBIOS are 
not limited to Novell's implementa¬ 
tion. They can also be used to allow 
DB2/2 to use IBM NETBIOS for 
TCP/IP or any other NETBIOS imple¬ 
mentation consistent with the LM10 
specification. Nor is DB2/2 the only 
application that can take advantage of 
multiple NETBIOS stacks. Any NET- 
BlOS-aware application, which allows 
the specification of a NETBIOS 
Adapter, can take advantage of these 
benefits. This includes DOS and 
Windows applications running under 
OS/2, 

Jeffrey Altman is currently a senior software 
designer at Columbia University's Kermit 
Software Development Group. He has been 
developing cross-platform communication soft¬ 
ware on IBM OS/2 and other PC operating sys¬ 
tems for several years. He is currently pursuing 
a Ph D L in Computer Science at Columbia 
University. His research topics include object- 
oriented techniques for distributing copy¬ 
righted or licensed information across hetero¬ 
geneous networks of computers. He can be 
reached at (212) 854-1344 or via Internet at 
jaltman@coiumbia, edu. 


NetWare NetBIOS 

internet on 

; allows routing of IPX NETBIOS packets 

sessions 64 

; maximum number of sessions increased to 64 

commands 128 

; max commands increased to 128 

names 128 

; max names in name table increased to 128 




Listing 7, Sample "Netware NETBIOS"section from NET.CFG file . 
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V Some useful programming tips: implementing multiple columns and drag/drop features 
in a PM listbox. 

By MARK MCMILLAN 


A Multicolumn 
Drag /Drop Listbox 


/ n the quest for ever easier user inter¬ 
faces, the listbox is a natural target for 
improvement in OS/2 PM. Mark Benge 
and Matt Smith described many listbox 
improvements in a series of articles starting 
in the January/February 1994 issues of OS/2 
Developer. Some of those improvements, 
most notably the removal of the 64-K data 
limit, were implemented in OS/2 Warp 3.0. 

Two particular concepts that they 
described, however, were never actually 
incorporated in their listbox replacement. 
(Hey, they are busy guys!) In this article, I 
will describe a custom PM control, which 
implements a true multicolumn listbox, and 
a subclass procedure, which performs drag- 
and-drop listbox reordering. These items can 
be used separately or together to create a 
multicolumn, drag-and-drop listbox. 

Unlike the Benge/Smith approach of 
writing a control from scratch, my tech¬ 
niques make extensive use of the existing 
PM listbox. The original concept of the 
MCLB was created by Charles Cooper of the 
IBM Warwick Development Group (IBM 
U.K. Ltd.). The drag-and-drop concepts were 
created by Allan Warren of IBM Yorktown 
Research. Working at IBM in Research 
Triangle Park, I rewrote both implementa¬ 



Figure 1 . A multicolumn listbox with sizeable columns. 


tions, added some features, and simplified 
the programming interfaces. 

SEEKING ROWS AND COLUMNS 

Applications often need to display data in a 
column format selectable by rows. 
Developers that prefer to avoid the complex¬ 
ity of the container control have tried vari¬ 
ous means to achieve a multicolumn effect 
with the listbox control. Common methods 
include using a fixed-pitch font so that char¬ 
acters align into columns or using an owner- 
drawn listbox with the application rendering 
the text of each item. Both of these methods 
have serious drawbacks in terms of visual 
presentation or code complexity. 

The multicolumn listbox control pre¬ 
sented here preserves the simplicity of the 
PM listbox but adds a visually pleasing mul¬ 
ticolumn capability, including proportional 
font support, movable column dividers, and 
column titles. 

A second common need for the listbox is 
to display a list of information in a specific 
order and allow the user to reorder the items 
or move them from one list to another. Many 
applications faced with this requirement 
resort to an elaborate set of pushbuttons or 
other controls to let the user move items 
within the list or between lists. The drag- 
and-drop function described here allows the 
application to easily support the drag and 
drop of items within a list (for reordering) or 
between lists (for moving or copying). 

The multicolumn and drag-and-drop 
listbox supports are independent of each 
other and can be used separately, or they can 
be combined to create a multicolumn drag- 
and-drop listbox. Both functions support 
"owner-drawn" listboxes for applications 
that need nontext listbox items such as 
bitmaps or other graphics. 
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Figure 2, An MCLB with fixed columns, 



Figure 3, An MCLB with bitmaps. 


MULTICOLUMN LISTBOX 
OVERVIEW 

A MultiColumn ListBox 
(MCLB) is a composite control 
consisting of a variable num¬ 
ber of listboxes, column sepa¬ 
rators, and column headings 
(Figure 1). The overall control 
organizes these components 
into a single user interface 
component- The control looks 
more like a container than a 
listbox from the user's point of 
view. However, from a pro¬ 
grammer's point of view, the 
MCLB is much more like a list- 
box (and, in fact, uses the usual 
listbox messages). The user 
operates an MCLB much like a 
details-view container. Records 
can be selected, and the split- 
bars moved to change the rela¬ 
tive column sizes. When the 
user clicks on an item in any 
column of the MCLB, the 
entire record (row) is selected. 

A single vertical scroll bar on 
the right edge scrolls the 
records up and down. The 
MCLB can optionally have 
horizontal scroll bars at the 
base of each column. 

An MCLB comes in two 
basic styles: one with columns, 
which are sizable via splitbars, 
and one with fixed-width 
columns and no split bars. 

Figure 2 shows an MCLB using 
fixed-width columns. Because the MCLB is 
based on the real PM listbox control, any of 
the usual listbox styles can also be used with 
an MCLB, such as LSJQRZSCROLL to place hori¬ 
zontal scroll bars at the bottom of each col¬ 
umn or LS_MULTIPLESEL to allow multiple 
record selection. LSJJWNERDRAV style is also sup¬ 
ported if the application wants to draw non¬ 
text items into one or more columns, such as 
the bitmaps shown in Figure 3. The MCLB 
supports any number of columns, but per¬ 
formance decreases in a linear fashion as the 
number of columns increase. 

Columns can be resized by positioning 
the pointer over a splitbar and dragging it to 
a new position. The columns adjacent to the 
splitbar are then resized (other columns are 
unaffected). The Alt-arrow keys can be used 


to move the splitbar with the Ctrl-arrow 
keys moving from one splitbar to the next. 

Each column of an MCLB shrinks or 
grows in proportion to its relative size when 
the MCLB window is resized. For example, if 
a column was 20% of the width of the MCLB 
before resizing the window, its width would 
be automatically adjusted to remain 20% of 
the window size. This resizing algorithm can 
be modified through the use of style flags. 

The MCLB supports the use of the sys¬ 
tem font and color palettes to allow drag and 
drop of fonts and colors. An MCLB can use 
different fonts and colors for the column 
headers and the data records. All columns 
are updated to use the same font or color 
when a font or color is dropped on an MCLB 
column. 
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typedef struct JCLBBFQ { 


char ‘Titles; 

// Title strings (TabChar separated) 

char TitlcFontDMILFOItTLEN]; 

// Title font (null for default) 

char ListFont[K«.FO#TLEN]; 

// List font (null for default) 

ULONC Titl«8Color; 

// Title background color 

ULONG TitleFColor; 

// Title foreground color 

ULONC ListBColor; 

// List background color 

ULONG ListFColor; 

// List foreground color 

LONG ‘InitSizes; 

// Ptr to array of initial sizes 

char .Reserved[64]; 

// Reserved for future use 

OORT Cols; 

// Number of columns 

char TabChar; 

// Data column separator character 

char _Padd; 

// Padd for separator character 

} HdBINFQ; 



Listing t MCLB initialization structure. 

The application can respond to 
user selections, de-selections, and the 
ENTER key like a normal PM listbox. 

PROGRAMMING AN MCLB 

If you are familiar with the PM list- 
box, then you already know most of 
what you need to use an MCLB* The 
MCLB uses the usual listbox messages 
for inserting text (LR_INSERTITEH) and 
for determining selection status 
(LW.QUERYSELECTIQN). A few differences 
exist, however, in creating an MCLB, 


and some additional control messages 
are generated* 

From a programming viewpoint, 
the MCLB is logically a single listbox. 
Each listbox item represents an entire 
row of the MCLB. When an item is 
selected in the MCLB, the entire row is 
highlighted and considered selected. 
Items in a listbox are addressed by their 
zero-based index (position in the list)* 
This index corresponds to the zero- 
based row number in an MCLB. When 
the application queries the text for item 


5, for example, the MCLB returns a sin¬ 
gle string, which represents all the text 
in row 5, and each column's text is 
delimited with a separator. 

CREATING AN MCLB 

The application must first create a data 
structure with the MCLB initialization 
data, including specifications for the 
number of columns, column titles, a 
separator character, and style flags* 
Listing 1 shows the HdBINFQ data struc¬ 
ture that the application constructs. 
The application then calls HCLBCreate- 
WindouO, passing the usual window- 
creating information such as window 
size, parentage, and the J1CLBINFQ struc¬ 
ture. A window handle is returned if 
the MCLB is successfully created. 

Most of the fields of the MCLBINFO 
structure are obvious, but a few benefit 
from some explanation: 

* The TabChar field contains a single 
non-null character that will be used 
to separate the column data in a sin¬ 
gle record* As will be discussed 
later, each record of the MCLB is 
logically a single string, with this 
character used to separate the data 
into columns. 

• The /InitSizes/ field is a pointer to an 
array of LONG values. There must be 
as many elements of this array as 
there are columns specified in the 
/Cols/ field. These values establish 
the initial size (width) of the 
columns and are relative for an 
HCLBS_SIZEHETHOD.PROP-style MCLB, 
since the columns will be propor¬ 
tionally expanded to fill the width 
of the control. For example: 

LONG ColSize$[3] * {21, 1L, 1L>; 

will create a listbox in which the 
first column is twice the size of the 
second and third columns* The ini¬ 
tial size values define the pixel 
widths of the columns for a style of 
MCLBS_SIZEMETHOD_LEFT* Any 
leftover space will be given to the 
left column. 

The MCLB does not currently 
support direct creation from a dialog 
template* However, it is very easy to 
get the same effect by defining a static 
rectangle (or any other control) in the 
dialog template to act as a placeholder. 
Listing 2 shows a VN.INITDLG sequence 
used to create an MCLB and then 
replace a static dialog control with it* 



Listing 2. Creating an MCLB in a dialog. 
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MCLB ITEM STRINGS 

In keeping with the listbox program¬ 
ming model, each item (record) in the 












Message 

Description 

MCLB.SETTTTLES 

Set new column titles (mpl is pointer to 
delimited string). 

MCLB.SETTXTLEFONT 

Set title font (mpl is pointer to font name/size 
or NULL to use default font). 

HCL6.SETLISTF0MT 

Set list font (mpl is pointer to font 
name/size or NULL to use default font). 

MCLB_S ETTTTL ECOL QRS 

Set title colors (mpl is foreground RGB, mp2 is 
background RGB)* If mpl“-mp2 then colors 
are reset to defaults* 

MCLB _ SETLISTCOL 0 RS 

Set list colors same format as title colors. 

MCL B _SETCOL SIZES 

Set column sizes (mpl is pointer to array of 

LONG)* 

HCLB.QUERYCOLSIZES 

Query current column sizes (mpl is pointer to 
array of LONG). Returned values are pixels. 

MCLB _QU ERYINF 0 

Query info (mpl is pointer to MCLBINFQ 
structure). App must free title string and array 
of sizes. 

MCL B _QU ERYSTY L E 

Query MCLB style flags* 

MCL B_QU E RY FUL LSIZE 

Query width of sum of columns (for example, 
width available for columns) 

M C L B_ QU ERYCTLCOL 

Query source of current UM_CONTRQL message 
(column number). Must be sent, not posted, 
and is only valid during M.CONTROL, 


Table t MCLB messages. 


MCLB control has a single text string 
associated with it. The string defines 
the text that is displayed on that row 
of the MCLB. A single separator char¬ 
acter is used to delimit where the text 
for each column begins and ends in the 
string. The separator can be any binary 
value except zero and is specified in 
the MCLBINFQ structure when the MCLB 
is created. 

Text strings are assumed to contain 
the separator characters when inserting 
or setting text in the MCLB* A null 
(empty) column is denoted by two adja¬ 
cent separator characters in the string. 
For example, the following item strings 
could be used for a 3 column MCLB 
with a / (slash) for the separator: 

John//Smith 
Steve/A/Campbell 
Eric 

The MCLB always returns fully 


delimited item strings when text is 
queried. The previous sample would 
be returned from an LW_QUERYITEHTEXT 
message as: 

Eric// 

INSERTING RECORDS 

Inserting items in an MCLB is 
done with the standard PM listbox 
messages. The listbox insert messages 
are extended with an extra field to 
specify the column for sorting. The 
extension is done by using part of the 
message parameters that are unused 
by the standard PM listbox messages* 
Here is an example of a new record 
inserted Into a three-column listbox. 
The record is inserted so that the third 
column remains in sort order: 

WinSendHsg(NCLBHund, LH.INSERTTTEH, 

HPF R0H2SH 0 RT(LIT_ SORT k SE NDING, 3), 

«PF ROH P ( 11 S t e v e/ A/Campbell")); 


This extension is defined for the ]j jJj|H 

LK.INSERTITEK and LW.INSERTMULTITEMS ■ 

messages* 

MCLB NOTIFICATIONS 

The MCLB control generates all of the 
usual listbox Wfl_CQNTRQL notification 
messages such as LN_SELECT and LN.ENTER, 

In addition, the MCLB control gener¬ 
ates some new messages to notify the 
owner of MCLB-specific events: 

* MCLBN_C0LSIZED is generated when the 
user changes a column size by using 
a splitbar, 

* MCL8N_QJST0MSIZE is generated when 
the MCLB window is resized and 
the HCLBS.SIZENETHOD.CUSTOR style is 
used* The application responds by 
setting the new sizes for all the 
columns* 

* HCLBN.PPCHANGED is generated when a 
presentation parameter (fonts or col¬ 
ors) in the MCLB has been changed. 

It is sometimes useful to know 
which column of the MCLB caused the 
generation of a particular notification 
message. The application can send the 
MCLB an HCLBJJUERYCTLCOL message to 
determine which column caused the 
WfLCQNTROL message. This query must be 
sent (not posted) while the application 
is processing the VH.CONTRQL message. 

MCLB MESSAGES 

All the usual listbox messages (LH_*) 
may be sent to the MCLB. The listbox 
messages can be used to select items 
(rows), query the text, query the 
selected items, change the text of an 
item, or set/query item handles. 

The MCLB supports some addi¬ 
tional messages for MCLB-specific 
functions plus the standard listbox 
messages, fable 1 lists all these MCLB- 
specific messages that can be sent to an 
MCLB, These include messages to set 
fonts and colors for the titles and data 
lists, setting new title strings, and 
querying various information about 
the size and status of the columns* 

OWNER-DRAW MCLB 

The MCLB control supports owner¬ 
drawing of the data columns. The 
application is responsible for drawing 
all the rows and columns of the data 
items of an MCLB with the LS.OWfODRAV 
style* (This style cannot be applied to a 
single column.) LS.OVHERDRAV can be 
used when the application wants to 
draw nontext items in one or more 
columns of the MCLB. 

The owner of an owner-draw 
MCLB will receive WM_ME ASUREXTER and 
WM_DRAVITEH messages just like a start- 
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1% 


case WORAWITEM; 

/* We get this message when an item in a column needs drawing. */ 
/* For column 1 we paint the supplied presentation space with a */ 
/* background and the bitmap. For column 2 we just return FUSE */ 
/* so the listbox viH draw the item text. */ 

if (SHQRTiFRDN«P(mpl) « I0,HCL&) { // Draw is from our HCLB 
DUNERITEPt *flwnerInfoj 
PQBITL Point; 

USHORT Col; 

Dwnerlnfo = (0WNERITEH Omp2; // np2 is ptr to OWIfERITEM 

// Get column this draw is for 
Col - SHORT2FRt3««P(mpl); 

if (Col != 1> //Let listbox draw text in 2nd column 
return (ARESULT)FALSE; 

// If redraw needed, fill background and draw bitmap 

if (Gunerlnfo-MsState == Ownerlnfo-MsStateGld) { 
WinFHU?ect(0¥nerInfO’>hps, AfOwnerlnfo^rdltem), CLR.CIAN); 

// Center bitmaps in the item rectangle 
Point.x a {QunerInfo~>rclIteffl.xRight 

- Owner In fo->rdIteffl. xLeft)/2 

- BmpHSize/2 + DwnerInfo->rdJtem.xLeft; 

Point.y - fOvnerlnfo-Hdltem, jTop 

- Ownerln fo->rclItem.y Bottom)/2 

- Bipy$i7e/2 + DwnerInfo->rclItea.yBottoi; 

// Bitmap handle Is item handle set when item was inserted 
yinDrawBitmap(OwnerInfo->hps» (BBITf1JlP)0vnerInfo->hIteni, 

NULL, ftPoint, OL, OL* 08M0RNAL); 

> 

return (^RESULT)TRUE; // Tell listbox that we drew the item 

} 

break; 


Listing 1 Processing VAJJRAYITEH for an MCLB. 



Figure 4 . Use of drag/drop listboxes 


dard PM owner-draw listbox. These 
messages will occur for each row and 
column of the listbox, (This is one 
place where the single listbox pro¬ 
gramming model does not apply.) 
These messages normally carry the 
item index in the first SHORT of mpl. 
The message is extended for an MCLB 
to cany the column number in the sec- 
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end SHORT of mpl . The 
application can examine 
both parts of mpl to 
determine which row and 
column is to be drawn. 

Listing 3 shows the 
processing of a VH JJRAVITEH 
message for a two-col¬ 
umn MCLB. The MCLB 
item handles are used to 
keep a bitmap handle in 
this sample application 
(SAMP2 in the toolkit 
SAMPLES directory). 
This handle is then used 
to render the bitmaps for 
column 1 during WM_0RAW- 
ITEH processing. For column 2, the 
sample just returns FALSE from WPCDRAV- 
ITEM, so the MCLB will draw the item 
text as usual (The application must 
still properly handle the WMEASUREITEH 
message for column 2 even though it 
is drawn by the MCLB.) 

Gaining access directly to the 
underlying listbox window of the 

OS/2 DEVELOPER 


MCLB may be necessary for some 
owner-draw functions. The MCLB cre¬ 
ates the column listboxes with an ID, 
which is the same as the column num¬ 
ber (1 based). To get the handle of the 
column 2 listbox, the application can 
use: 

ColSHwnd = WinQueryWindowFromlB 

(HGJHvnd, 2); 

The window handle can be used to 
obtain a presentation space. The pre¬ 
sentation space can then be used for 
VinDrawText (...DT_QUER¥EITENT) to accu¬ 
rately measure the size of text strings 
in the listbox. 

DIRECT-MAN 1 PULA TiON LISTBOX 

The Direct-Manipulation ListBox 
(DMLB) is another extension to the ba¬ 
sic PM listbox. The DMLB is a sub¬ 
classing of a listbox and is unlike the 
MCLB, which is a composite custom 
PM control. 

Applications often need to present 
a list of items in which the order of the 
items is significant. The listbox (or 
MCLB) control can be used to present 
such an ordered list. However, the 
user interface becomes more difficult if 
the application needs to provide a 
means for the user to specify a new 
ordering. Typically an application 
would have to resort to a series of 
pushbuttons and multistep user inter¬ 
actions to let the user reorder items in 
the list. The user interface is often 
clumsy and requires many user inter¬ 
actions to do significant reordering of 
the list. 

Some applications also need to 
allow the user to move items from one 
listbox to another. For example, a data¬ 
base export program might present a 
list of fields in the database and let the 
user choose the fields to be exported. 
The exported list of fields appears in 
another listbox. Applications typically 
provide insert/delete or move buttons 
between the listboxes to let the user 
move items back and forth between 
them. Again, the user interface is not 
always intuitive and requires several 
interactions to control it. 

The DMLB addresses these prob¬ 
lems by adding easy-to-use drag-and- 
drop capability to the listbox (or 
MCLB) control. The user can drag a 
listbox item to a new position in the 
same list or to another list. The appli¬ 
cation controls what happens when 
the user drops the list item (the item is 
moved, copied, or deleted). The listbox 
can be scrolled while dragging by 








































Listing 4 Setup of a drag-and-drop listbox . 


moving the drag pointer above or 
below the listbox. 

Figure 4 illustrates how a DMLB 
is typically used in a database applica¬ 
tion. The left listbox shows all the 
fields in the database, and the right list 
shows the fields selected for exporting. 
The user can drag-and-drop reorder 
the right list to change the order of 
exported fields. He/She can also drag 
fields from the left list and add (copy) 
them to the right one. Dragging a field 
from the right list to the left deletes it. 
With the DMLB, the user is able to eas¬ 
ily choose database fields and order 
them for exporting without any addi¬ 
tional dialog controls or complex user 
interactions. 

PROGRAMMING THE DMLB 

The Direct-Manipulation ListBox is not 
a custom control but rather a subclass¬ 
ing of the standard PM listbox. Thus, 
an application first creates the listbox 
in the usual fashion and then calls the 
OHLIInitializeO API to establish the 
subclass and initialize the DMLB 
instance data. Listing 4 shows how a 
listbox control is set up for direct 
manipulation during WH_INITDLG pro¬ 
cessing of a dialog. 


The DMLB 
subclass, as imple¬ 
mented, will use 
the listbox window 
words (QWL.USER) for 
a pointer to 
DMLB-reiated in¬ 
stance data. The 
listbox window 
words are not 
available for appli¬ 
cation use. How¬ 
ever, the DMLB 
reserves the first 
PVOID of its own 
instance data for 
application use. 

The application 
can use the first 
PVDID of the DMLB 
instance data if it 
needs to associate 
data with the list- 
box control. 

The drag-and- 
drop listbox sup¬ 
port involves a 
simple message protocol between the 
source listbox (where the drag origi¬ 
nates) and the target listbox {where the 
user drops the item). The source and 


target may be the same listbox. When a 
listbox item is dragged over a listbox 
window, the potential target window 
is "probed" to determine if an item can 







Hyperwise V2,0 for 0 
productivity tool for application developers 
which enables WYSIWYG authoring of 
hypertext online information and application 
help. Using Hyperwise, y o u ca n create 
multimedia-rkh online books and help text, 
or effective tutorials and training materials. 
Key featu res of Hyperwise 2,0 include: drag- 
and-droptechniques; link text, graphics, 
audio and video; IFF book master and RTF 
import; INF, HIP and HTML export, 
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VisualAge €++ 

by IBM 


dMREXX idbtUB 

by dSoft Development 
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VisualAgeO-F Version 3.0 is a powerful 
C+ + application development environment 
that combines visual programming with 
robust professional tools. Developers can 
visually build applications from parts and 
combine the pa rts to construct programs. 
This product includes: IBM Open Class 
Library and an extensive set of programmer 
tools ■ C/0% + compiler, editor, browser, 
debugger and performance trace analyzer. 

Mi Packs f Upgrades and Additional 

Licences Available - Call for Pricing! 


This dynamic I ink library provides simple, 
affordable data base management from your 
OS/2 REXX programs. Now accessing dBase 
files is unimaginably easy. 
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The solution for harried MIS developers! 
Allows multiple users to access dBase files. 
Provides a consistent set of API's across OS/2, 
DOS, Windows & Windows NT, 
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WN.CDMm Code 

Description 

UJKLB.DELETE 

Item is about to be deleted (current selection). 

LN JMLBJJELETE.HO V E 

Item is to be deleted for moving to another listbox. 

LNJ3HIB_REORDERED 

An item was moved within the same listbox. 

LN.0KLB.INSERT.N0VE 

Item was inserted via drag: HOVE (current 
selection). 

LI.WLB.aSERT.C0PT 

Item was inserted via drag: COPY (current 
selection). 

LN.0MLB.QRVDR0P 

A drop is about to occur on this listbox, return 
OK-todrop flag and drop-mode flags 
(nove/copy/delete). 

LN_DN18.C<MTEKT 

A context menu was requested on the listbox. 


Table 2 DMLB notification messages. 


be dropped on it. The target responds 
to the probe with various codes; it can 
refuse the drop, or if the drop is 
allowed, the target will decide if the 
drop is to be a move, copy, or delete of 
the original item. The mechanics of the 
dragging and probing is automatically 
done by the DMLB subclass proce¬ 
dure. The application only needs to 
respond to a few WH.CONTROL notification 
messages. 

The complete list of DMLB notifi¬ 
cation messages is shown in Table 2. 
To implement a simple drag-and-drop 


re-ordering capability in the listbox, 
the application needs to respond only 
to the LN.OHLB.QRYDROP message. Listing 5 
shows the processing of this message. 
The listbox will accept drops on itself 
for reordering items but refuses drops 
from any other listboxes. 

The owners of the source and tar- 
get listboxes will receive messages 
when items are moved, copied, or 
deleted by drag-and-drop methods. 
The application can ignore these mes¬ 
sages, if they are not of interest, or 
process them as required. For example, 


the application may use the listbox 
item handles to keep track of dynami¬ 
cally allocated data for each item in the 
listbox. The application will want to 
process the LN.DMLB.DELETE message to 
free the data when the item is deleted 
due to a drag-and-drop operation. 

DMLB CONTEXT MENUS 

Another useful feature of the DMLB 
subclass is the ability to notify the 
owner when the user requests a con¬ 
text menu. The DMLB subclass will 
send the owner an LN.DHLB.CONTEXT mes¬ 
sage along with the index of the item 
on which the context menu was 
requested. Therefore, the application 
can provide direct actions on listbox 
items via context menus. Figure 5 is a 
listbox with a context menu for adding 
new items, editing items, and deleting 
items, 

DRAG-AND DROP IMPLEMENTATION 

The current DMLB subclass uses a pri¬ 
vate drag-and-drop message protocol. 
It is designed so that a drag of a listbox 
item over a listbox, which is not sub¬ 
classed with the DMLB, will result in a 
"no-drop allowed" condition. The 
DMLB subclass handles capture of the 
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case YH.CONTfiOL: // Control notification 

svitch SHORTlFRO«MP(mpl) { 

case H>_LISTBOX,; // Froia drag/dfOp listbox 

switch <SK0RT2FR0MMP(mpl>) { 

case LN JHLB.QRfDROP: 

// If dropping in same listbox* mowe the item* If drop is 
U from some other listbox* refuse it* 

if (HWNDFROMMP(mp2) “ WinWindowFromlDthwnd, BJJSTBQK)) 
return HRFR0M2SHQRTCTRUE* DROPMODE.HOVE); 

return HRFR0rt2SMGRT(FALSE, 0); 


Listings . Processing LW_DML6_QRTDROP message. 



Figure £ Ustbox context menu. 

mouse pointer, sets the shape of the 
pointer, and probes the window under 
the pointer to determine suitability for 
dropping. 

The DMLB subclass does not use 
the PM OrgOragO API to implement the 
drag-and-drop functions* The advan¬ 
tage of this implementation is code 
simplicity (no complex drag data 
structures or message protocols), 
thereby allowing the owner of the list- 
box to respond to a very simple set of 
drag-and-drop messages. The disad¬ 
vantage of this approach is that it pre¬ 
cludes integration with the Workplace 
Shell. For example, a listbox item can't 
be dragged to a WPS folder. The 
intended scope of the DMLB subclass 
is only to support drag and drop on 
listbox class objects. 

SUMMARY 

The MCLB and DMLB provide 
Presentation Manager applications 
with intuitive and visually clean exten¬ 
sions to the common listbox control. 
Implementation in existing or new PM 
applications is made quick and easy by 


the use of the familiar listbox 
programming model. With a 
minimal amount of code or 
programmer training, an appl¬ 
ication can provide a sophisti¬ 
cated user interface with tabu¬ 
lar data and/or drag-and- 
drop features. A complete 
toolkit, including full source 
code, online programming ref¬ 
erences, and working samples 
is available* 


Mark McMillan is an advisory 
engineer with IBM's Networking 
Software Division at Research 
Triangle Park f N.C. He received his B.S. at the 
University of Michigan and completed his M S. 
in computer engineering at Duke University. 
McMillan is currently developing user interface 
components for IBM's Personal Communica¬ 
tions software products. 
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cluding complete source code, 
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tion, are available on Compu¬ 
Serve's OS2DF2 forum, OS/2 
Developer section. Download file 
MCLB .ZIP. 
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The dBase Database Access For REXX 

° Works with DBF, pg_T., NPX and MPX files, 
o Supports dBase III and IV file formats, 
o Uses standard REXX API function calls, 
o Comes with a GUI Front-End for Database Maintenance. 

Find the shareware version RXBAS203.ZIP on your favorite BBS. 

Use it with VisPro/RexXjVX Rexx and GpfRexx 
American Coders, Ltd. Post Office Boic 97462 Raleigh, NC USA 27624 
(919) 846-2014 

internet: joe@usacoder.rtp.nc.us CIS: 74150 f 2370 
I_ Only $95.00 + shipping & handling _ 
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directly from OS/2! ' 

•Easy-to-use workplace shell application 
•Includes a command line interface 
• You can f page-en able * y ou r applications! 
•32-bit, SOM-based code - Only S79l 

ChipChat® Wireless Communicator 

from ChipChat Technology Group 
Dearborn , Michigan USA c£ Koga. Fukuoka Japan 

Phone 313-565-4000 http://www.chipchatcom 
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FAX Developer Tools 

From the developers of FaxWorks for OS/2 

Client/Server API and Printer Driver Toolkits 
Support for LANs, up to 96 lines per CPU, 
and all popular fax hardware 

Keller Group Inc. 

Vo ice: (612) 429-7273 Fax: (800) 329-3293 

Email: kgroup@ibm.net Fax: (612) 653-1987 

Faxwork^ is a trademark of Global Village Communication. 


TCP/IP for OS/2® 

Our customers say our tcp/ip 
is the best because 
it’s faster, more complete, 
and reliable. 

Find out for yourself! 

' 

Supported: all released versions of OS/2 
including 32bit API for 2.x and above; 
SLIP and/or PPP on COM1 and/or COM2; 
Ethernet; Token Ring; ARCNet; NDIS and ODI 


Opt-Tech Sort/Merge 


Use as a stand-alone utility or call as a Subroutine. Many 
features including unlimited fife size, multiple keys, record 
selection, duplicate elimination, summing and more! 

Opt-TechData Processing 
P.O. Box 678 
Zephyr Cove, NV 89448 
Phone (702) 588-3737 
Fax (702) 588-7576 


Essex Systems, Inc. 

One Central Street, Middleton, MA 01949 


Available for: 

OS/2 or Unix $249 
DOS or Windows $149 


A Dan Lanciani Product 

TCP/2 is « Trademark of DLD consulting. All other products and trademarks ire the property of 
their owthis. TCP/2 i$ Based in part oa work dow by the Voivanity of Oilifofttia Berkeley. 
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The easiest to use t most powerful 32 bit OS/2 PM IPF Language Editor,. 

New! IPF Editor 2.0 

Designed for intuitive use by anyone 
Supports all IFF Tags, with simple index creation, easy 
multiple-window creation, and drag-and-drop panel ordering 
Generate C program and Resource source 
to add help to applications in minutes 
Import WordPerfect, Describe and RTF 
Preview IPF output without compiling 
Create all hypertext links automatically 
Sound Support and Spell Check 
Complete on-line help and documentation 
Optional multi-user nework version 


Orders: 
l-800-IPF-7622\ 

Information: (3 60) 428-5025 


on CompuServe at 
70410,2416 


Perez Computing Services 
4725 Monte Vista Place 
Ml Vernon, WA 96273 



PrntScrn Screen Image Utility 
by MITNOR Software 

4 Integrated Utilities for 1 Economical Price 

* Screen Printing/Screen Capture 
8 Capture methods/? File Formats 
Print to Local or LAN attached printers 
* Clipboard Viewer with Import, Export & Printing capabilities 
* Screen Saver with 9 Dynamic Display Types 
* Date Time Information Bar 

Available From 

Indelible Blue 1-800-776^8284 
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Jagre Smart Link 




Jagre SmartLink and Lotus Notes: 
A Winning Combination! 


In today's computer world, communicating effectively and quickly could I 
be the difference between your company being a dead company or being a I 
quick company. 

Using Lotus Notes within your company, gives your company the ammu- | 
nition it needs to be a quick company. 

Now, Jagre, Inc. provides your company with the competitive advantage 
to being — and staying — a quick company: Ja g re SmartLink . 

Jagre SmartLink is a set of Lotus Notes-enabled tools grouped together 
in one place to empower your IBM OS/2-based desktop applications to 
communciate effectively and quickly with Lotus Notes for Document 
Management, E-mail. Fait, Pager, OCR, Voice, Video, and User-based 
Agents to gets tasks done quickly. 


With Jagre SmartLink, the powerful features of Lotus Notes are now a button | 
click away! 

Click on any Jagre SmartLink tool for instant access to Lotus Notes, Now, 
you can use Lotus Notes and the Lotus Notes Companion Products with your | 
desktop applications to communicate quickly with someone down the hall or 
across the world! 

Now, your ammunition arsenal is complete with Jagre SmartLink and their 
I arsenals are not!! 


Jagre 


SmartLink 


For a free demonstration copy of Jagre SmartLink to discover how it can 
help your company be a quick company, not a dead company, call or 
write Jagre, Inc, at (617)424-8302. 102 Gainsborough St #202E Boston, 
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It’s easy 
to integrate 
business graphics 
into your 
OS/2 PM 
or 

Windows 3,NT,95 
applications 


Developer’s Business Graphics Toolkit 


• High-level APIs 

• Tactile feedback 

• Real-time charting 

• 16-bit and 32-bit 


• Dynamic Link Library 

• Positive/negative data 

• Printer/meta file support 

• 25+ chart types 


The Croauley Group 
P,0. Box 921759 
Norcrott, GA 30092 
USA (77OJ 751-3703 
Int'l 44 932-&44-281 
(dome available} 
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VisualAge & PARTS 

Spreadsheets, business graphics, tables, and other powerful controls 
are are easy to add to your VisualAge™ and PARTS™ applications, 
WidgctKiPYProfessional provides spreadsheets, tables, virtual 
spreadsheets, spreadsheet designer, load and save, printing, and more. 
WidgetKi(/Business Graphics has versatile graphs and charts. 
Subpanes/V for PARTS has a powerful table pane, columnar list box. 
heirarchical list box, 3-D frames, 3-D and bitmap buttons, and more. 
No royalties for end-user applications, 90 days free support, and 
30-day money-back guarantee. Call or fax for free info, 

Objectshare Systems, Inc. v: 408,9707280 f: 408.9707282 
5 Town & Country Village, Suite 773, San Jose, CA 95128 
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me Awh - ‘-Winning, Multi-Function Desktop Enhancements for OS/2* 


Building A 
Better Desktop 


Presenting the DevTech Family of Productivity Tools for the OS/2 User. 


DeskMan/2 1 



> Manage, secure t and customize your OS/2 
environment tike never before! 

1 Provide personalized desktops for each user ; 

1 Switch between as many as 81 "Virtual 
desktops '—like having up to 81 monitors that 
ail fit right on your desk! 

Save and restore entire system configurations. 


Best selling DeskMan/2 is the award-winning enhancement for all 
personal and corporate OS/2 users. This comprehensive, flexible, one- 
of-a-kind suite of multi-function tools makes it easy to use and administer 
OS/2, from the standalone PC to the LAN! Install, configure, backup, 
secure, and otherwise manage desktops locally or remotely. Enhance 
productivity with virtual desktops and Workplace Shell Extensions. 
Authorize access to individual DeskMan/2 and Workplace Shell 
features on a user by user basis. Take complete control of the WPS 
via a simple drag & drop interface, or a powerful API (including full 
support for REXX, CID and LAD/2), Review after review concludes 
that DeskMan/2 is a "must have” for all OS/2 users. IBM even features 
DeskMan/2 in its own “Red Book” on WPS configuration. Why not find 
out for yourself? 



The DeskMan/2 ™ Productivity Pack 

* DeskMan/2 v 1.51b plus FREE upgrade to 
DeskMan/2 v2.0 (when available). 

• DCF/2 Lite The “on the fiy” data 
compression for OS/2. 

9 The Graham Utilities for OS/2 , Limited 
Edition* - Special selection of disk utilities. 

• Relish® v2.12 -Award-winning calendar, 
reminder & personal planner for OS/2. 

* CPU Monitor Plus ™ Special Edition* - 
professional OS/2 performance monitor 
and analysis package. 

Current DeskMan/2 users can upgrade 
to the Productivity Pack . Caff for details. 

Take the award-winning DeskMan/2 product; include features 
previously available only to corporate users, such as enhanced 
security and Workplace Shell auditing; add a leading edge selection 
of invaluable OS/2 utility products; and top the whole thing off with an 
incredible array of upgrade offers—that is the essence of the wildly 
successful DeskMan/2 Productivity Pack! This is one-stop-shopping 
for alt your essential OS/2 needs, and has been called nothing less 
than “the OS/2 Survival Kit!" 


'Specie! Editions created 
exclusively for the 
Productivity Peck. 


DCF/2 1 


MB 

1 • All new version! 



* Now twice as fast and ultra reliable! 



• Real world compression > 2.5:1. 



* No pre-allocation required - dynamic space 



management. 



* Unique disk server architecture. 
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The Graham Utilities 

A 



DCF/2 brings the power of a disk server architecture, usually found 
only on expensive mainframes and high-end minicomputers, down to 
your OS/2 desktop or notebook machine. Use HPFS without having to 
repartition or reformat your existing hard drive; DCF/2's unique 
architecture allows it to create virtual HPFS drives anywhere that 
OS/2 can create a file: FAT partitions, floppy disks, removable hard 
drives, Novell servers, LAN Server volumes, you name it—DCF/2 
volumes go anywhere! Plus, DCF/2 volumes grow and shrink as needed 
so you don't need to pre-alocate disk space! Copy entire HPFS virtual 
drives between computers as easily as copying a single file. New "After 
image Journaling" technology brings even more mainframe 
power to the PC T and gives DCF/2 the most reliable data storage you 
can buy for OS/2—even surviving power failures! 


* Comprehensive suite of disk, file and general 
purpose utilities. 

* The only LAN compatible disk recovery tools 
for OS/2! 

* Edit, manage and repair local and remote disk 
drives. 

* Restore corrupt partitions, recover lost data r 
diagnose system problems. 

* Much r much more — 50+ modules in afil 


The Graham Utilities is the most comprehensive suite of disk, file and 
general purpose utilities available for OS/2. This powerful suite contains 
tools that range from system diagnostics, to file and disk management, 
to helping you deal with the Internet. Recover lost data, undelete 
files, edit, manage and repair disk drives — even remote disk drives 
on LAN Server, LAN Manager, Lantastic and Novell Netware! The 
package includes an extensive 300+ page printed manual detailing 
all aspects of the product and its use, complete on-line documentation 
for easy access, and the unique Graham integrator that literally walks 
you through the entire suite. A “must have" for every OS/2 user! 


7 cant imagine being without it.’ f 

Dave Barnes. IBM 
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DevTech _ 

Development Technologies, Inc. 

Software Development <£ Technology Transfer 

306 Spcingwood Rood. Fore&l Acres, SC 29206*2113 
Voice: (603) W9230 * Fox- (603) 736-0210 


DeskMan/2 dramatically improves the ability of corporations and users 
to get the most out of OS/2. DeskMan/2 helps administrators restrict 
and control what users are doing and provides robust backup/restore 
features and seamlessly enhances the features of the WPS" 

Dr. Mike Kogan. Lead Architect of OS/2 2M 

Author. The Design of OS/2 

Copyright 1995 Development Technologies. Inc All rights reserved. DeskMan. DeskManviJ. VUE Man. 
VUEMarv2, E>M£lmage. OCF/2 and DCRffl LUe are trademarks Development Technologies. Enc. Bunding 
A Belief Desktop is a service mark ol Development Technologies, Inc. Workplace Shell Is a trademark 
of international Business Machines Corporation, IBM end 05^ are registered trademarks Interna¬ 
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lultimedia 


OpenDoc gives developers a whole new way to create applications. Here's a great way 
to leverage multimedia technology. 

By SCOTT BROUSSARD 


Accessing Multimedia 
Data from OpenDoc 



Scott Broussard 


m ow that OpenDoc has given ap- 
f If plication developers a new com- 
g ponent-based platform in which 

to develop applications, and multimedia is 
starting to find its place in mainstream ap¬ 
plications, the first thing a developer needs 
to do is understand how to leverage multi- 
media technology, such as digital audio, 
and embed it in an OpenDoc compound 
document. 


ABOUT STORAGE UNITS 

OpenDoc uses a compound document tech¬ 
nology, called Bento, to store the data of var¬ 
ious types of component parts in a docu¬ 
ment. The OpenDoc run time reserves an 
area of the compound file for use by each 
part, called a storage unit. The OpenDoc pro¬ 
gramming interfaces provide a class called 
GDStorageUnit that encapsulates the compo¬ 
nent's access to the Bento file. Within each 
storage unit, there is a set of properties, 
where each property has a set of values. 
Listing 1 shows the architecture of the stor¬ 
age unit 

Properties and Values have names that 
are strings. These names are frequently ISO 
Strings. ISO Strings are scoped names that 
contain various substrings delimited by 
colons to ensure that they are unique across 
any domain in which they need to be 
unique. These substrings generally contain a 
company or organization name. For exam¬ 
ple, "IBM‘SamplePart:Kind" is an ISO string that 
could be used as a Property or Value name. 

Access to data within a storage unit is 
similar to access to data within a traditional 
data file, although some key differences do 
exist. 

The ODStorageUnit class needs to maintain 
control over its interna! structures, and 
therefore, provides Lock() and UnlockO func¬ 


tions to ensure that several threads don't try 
to access the same storage unit concurrently. 

The ODStorageUnit class has the notion of 
Focusring a particular Property and Value 
pair with the FocusQ method. This allows the 
other methods on the storage unit to operate 
on a particular segment of data. Only one 
Property and Value pair can have the focus 
within the storage unit at one time. 
Therefore, it is essential to lock the storage 
unit while accessing data, so that no other 
threads change the context of the storage 
unit. 

The ODStorageUrcit class allows the appli¬ 
cation to determine if a particular Property 
or Value exists without causing an error. 

Data can be read from the storage unit 
with the GetValueO method and written with 
the SetValueO method. These methods access 
the data at the currently set offset, which can 
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Listing i. Storage unit architecture. 
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be modified with SetOffsetO* It is important 
to note that when the Property loses the 
focus, the offset is reset, 

ABOUT MULTIMEDIA 10 

If an application component, such as a per¬ 
sonnel information manager record that con¬ 
tained embedded audio, wanted the multi- 
media subsystem to access the data directly, 
without having to shuffle the data back and 
forth from a simple file and a storage unit of 
a compound document, the application 
would want to use a Multimedia IO (MMIO) 
Storage System IO Procedure. 

The multimedia programming inter¬ 
faces are set up to primarily deal with files 
that contain the common multimedia data 
formats, such as .WAV or .AVI. Fortunately, 
the MMIO Manager is organized into both 
File Format IO procedures, which manipu¬ 
late the layout of the data, and Storage 
System IO procedures, which manage where 
the data is stored. This allows data to be 
stored in either files or memory, or in the 
case of Open Doc, in Properties of a storage 
unit that are reserved from the component. 



Listing Z Multimedia 10 Procedure architecture. 

Listing 2 shows how the MMIO 
Manager layers its IO Procedures to allow 
the data to be stored anywhere but still uses 
the same code to manipulate the layout of 
the data. 

By writing a MMIO Storage System IO 
Procedure, the Open Doc component handler 
that is using multimedia data types within a 
compound document can use the existing 
multimedia subsystem transparently with¬ 
out making any modifications or doing any 
of the basic work itself. As in Listing 3, it can 
implement an IO Procedure that uses the 
QDStorageUnit object to store and retrieve the 


multimedia data from within the compound 
document, 

USING THEM TOGETHER 

In ordeT to begin thinking about an 
OpenDoc Storage Unit IO procedure for 
MMIO, it is necessary to understand that the 
multimedia programming interfaces are 
used to dealing with media object names, 
which are usually file names. 

The MMIO manager identifies which 
Storage System IO Procedure should be used 
based on the syntax of the media object 
name. Simple file names and paths are di¬ 
rected to the DOS Storage System IO 
Procedure, which uses OS/2 File System 
APIs to implement the necessary functions. 
If the media object name is a file name with a 
V sign and an element name, then the BND 
(Bundled or compound) file Storage System 


I Multimedia enabled OpenDoc component 1 


I Multimedia 10 Manager | 



| File format ID Procedure | 


I Storage System 10 Procedure I 


I DDStorageUnit class | 
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Listing 3. Multimedia OpenDoc Storage Unit 
architecture. 
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Listing 4 . Sample media object naming syntax. 


IO Procedure is used. The Bundled file 
is a legacy compound file format that 
is built into MMIO, but it shouldn't be 
confused with the OpenDoc com¬ 
pound file, as they are different things, 
if no media object name at all is given, 
and a memory block is provided, then 
a memory file vrill be used. 

The media object name is the key 
to making the MMIO Storage System 
IO Procedure for OpenDoc Storage 
Units work. The media object name 
must contain all of the information 
necessary to access the object properly, 
which includes ensuring that the 
MMIO subsystem correctly identifies 
the OpenDoc IO Procedure when ap¬ 
propriate and that the correct Storage 
Unit, Property, and Value names are 
accessed. The programmer has some 
freedom in determining the syntax of 
the media object names that the 
Storage System IO Procedure will use. 

The MMIO Manager uses a nam¬ 
ing convention to help expedite the 
identification of the Storage System IO 
Procedure, A dot, followed by the 
FOURCC (Four Character Code) used 
by the IO Procedure and a sign, 
will ensure that the correct IO 
Procedure is used. 

Listing 4 shows the possible syn¬ 
tax of the media object name that con¬ 
tains the necessary information. The 
components of the name are delimited 
by V signs because they are consistent 
with the legacy compound file naming 
convention but are not required. 

Because the OpenDoc component 
handler is passed an ODStorageUnit * 
when it is created for storing its data, 
and a storage unit may or may not 
have a valid name, it is necessary to in¬ 
clude the pointer in the name of the 
media object. It is possible to pass the 


pointer in the form of a string em¬ 
bedded as a piece of the com¬ 
pound name. The Property and 
Value names should also be in¬ 
cluded in the compound name. 
Finally, the appropriate file ex¬ 
tension for the data should be ap¬ 
pended to the Value name, so that the 
Media Device Manager (MDM) can 
properly route the open request to the 
appropriate MCI Driver. Combining 
the file extension (normally be used 
for the data) to the Value name and 
stored in the document is preferable. 
If, for example, the data is a ,FL1 or 
,FLC animation file, which are nor¬ 
mally silent, the File Format IO Pro¬ 
cedure in OS/2 looks for a corre¬ 
sponding ,WAV file to use as an 
audio track. If there is another Value 
that has the same name, but with a 
.WAV extension, then it could be used 
for the audio track. 

IMPLEMENTING THE STORAGE 
SYSTEM 10 PROCEDURE 

The MMIO Storage System IO 
Procedure must implement the set of 
commands shown in Table 1. 

Since a pointer embedded in the 
media object name is being passed to 
the IO Procedure, the IO Procedure 
may want to validate it somehow be¬ 
fore accessing it. The OpenDoc compo¬ 
nent handler can register valid storage 
units by adding them to a list. When 
an HMION.OPEN or an MMIQH_IDENTIFYFILE 
occurs, the IO Procedure can validate 
the pointer as being a valid 
QDStorageUnit *. The Storage Unit is re¬ 
moved from the list when the object is 
no longer accessible. 

WHIQIi_BEGINSTREAM and NMI0H_END- 
STREAH are used to indicate when play¬ 
back or record is occurring. This gives 
the IO Procedure the opportunity to 
request a certain level of service from a 
network. The ODStorageUnit MMIO IO 
Procedure need only return 0. 

The MMIGM_GETFORMATINFQ message 


HMIQMJPEN 

MMIOM.CLOSE 

mmjm 

MMIOfLHRITE 
MHIOfLSEEK 
MHI0MJDEN1TFYFILE 
M MI0N _GETFORM A TIN F Q 
MHIQH _GET FORM ATHIME 
HHI0M_ BE GUSTRE A M 
MMIQH.E1YDSTREAM 


Open the specified media element 

Close the media element 

Read a block of data 

Write a block of data 

Seek to a specified offset in the data 

Identify the media element name 

Return information about the IO Procedure 

Return the name of the IO Procedure 

Begin streaming the data 

End streaming the data 


Table T . Required MMIO messages for Storage System 10 Procedure. 


provides capability information about 
the storage unit to the MMIO manager. 
The JO Procedure should indicate that 
it is a Storage System IO Procedure 
rather than a File Format 10 Procedure. 
It should also indicate that it can 
r ead/ ¥ rite/ seek / readu rite u n tra nsla ted. 

The MMIDM.GETFORMATNAME message 
simply returns a user-read able name 
for the Storage System IO Procedure, 
however, no applications that 1 know 
of actually display Storage System IO 
Procedures. 

For MHIQODENTIFYFILE, the IO 
Procedure should validate the format 
of the name and return MMIQ^SUCCESS if it 
is valid or MMIQ.ERRQR if it is not valid. 
At this point, the ODStorageUnit * 
shouldn't be validated against the list, 
but rather during the KMIQM,QPEN pro¬ 
cessing. If the IO Procedure fails to 
identify a name that is in fact intended 
for the ODStorageUnit IO Procedure, it 
will then probably be identified by the 
DOS IO Procedure, and the file system 
will surely report an ERROR,OTALID_NANE 
error. 

The IO Procedure will need to 
have an instance data structure that 
contains the open flags, the QDStorage¬ 
Unit *, the Property name, and the Val¬ 
ue name. These instance data struc¬ 
tures should be linked together into a 
list so that multiple opens of the same 
Property/Value pair can be detected 
and access control emulated (like the 
File System). 

IMPLEMENTING OPEN 

The HMIQM JPEN processing is the most 
complicated. The errors returned from 
the IO Procedure are important so that 
the use of this IO Procedure is trans¬ 
parent to existing software. This means 
that OpenDoc ODStorageUnit error con¬ 
ditions should be translated to MMIO 
errors or OS/2 File System errors. File 
system errors are frequently put into 
the ulErrorRet field of the KMIOINFO 
structure. 

When processing the MHIOMJPEN 
message, the IO Procedure should val¬ 
idate the name to ensure that it has all 
of the required pieces of information. 
If it isn't a valid name, the procedure 
should return HMIQERR,INVALID^FILENAME, 

The procedure should then deter¬ 
mine if there are any other instances 
being accessed and check the open 
flags of both instances to determine if 
they are compatible. If they are not 
compatible, then return MMIOERR^IN- 
VALID_ACCESS.FLAG. 

The instance data structure can 
then be initialized. Typically, the 
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ULQNG EXP ENTRY SUIQProcOpen( PHMIOINFO pmmioinfo, 


LONG IParaml, 
LONG IParaml) 


ULQNG size = 0; // size of property 

ULGNG rc; // return code 

PS2 pszFileName // file name 

PSUIWFO pSUInfo; // Storage Unit object instance information 
BOOL flock = FALSE; // Storage Unit locking 
Environment * ev = somGetGlobalSnvironmentO; 


if Opmriioinfo} return (NHIO^ERROR); 
pszFileName = (PSZ)lFarami; // get the filename from 
parameter. 

if (!pszFileName) return (KMIGERR.INVALIO.FILENAHE); 

// validate name {basically identify the object) 

pSUInfo E YalidateName (pszFUeNairie); 

if (!pSUInfo) return (MNIOERR.INY ALIDJTXENAWE); 

ReleaseN ane (pSUlnfo); 

// Get access to the object 


pSUInfo a AecessName (pszFileName, pmmioinfo^ulFlggs}; 
if (IpSUInfo) return (MMIOERR.INVALIDJCCESSTUG); 
pmmi£>info->aul[nftj[l] * (ULONG) pSUInfo; // save it for later 

// complete the open 

if {pmmioinfo->ulELags I MIO.DELETE) { 


pSUInfo->key = pSUInfo->pStorageUnit->Lock (ev, 0); 
if (!IsE*ception(ev)) { 

if (pSUInfo->pStorageUnit->Exists (ev, 

pSUInf cr >szPropertyName, 
pSUInf o->s zYalueT ype, 

0 )) { 

pSUInfo-ipSto rageUnit->Focu s (ev, 
pSUln fo-> szP rope rty Na me, 
kOOPosFirstSib, 
pSUInfo->szValueType, 

0, 

kODPosFirstSib); 
if (!IsException(ev)) { 

pSUInfo->pStorageUnit->Remove(ev); 
pSUInfo->pStorageUnit->Unlock {ev, pSUInfo->key); 
} else { 

pmmioin f o->ulE r ro rRet = E R RO R_ FILE .N0T.F0UN D; 
pSUInfo->pStorageUnit->Unlock (ev, pSUInfo->key); 
ReleaseName (pSUInfo); 
return (ERR0R_FILE_NOT FOUND); 

> 

> else { 

pmmioinfo->ulErrorflet - ERROR.FILE.NQT.FQUND; 
pSUInfo->pS to rageUni t- Mil nlock (ev, pSUlnfo->key); 
ReleaseName (pSUInfo); 
return (ERROR.FILE JGT.FGUND) 


} else { 

pmmioinfo->ulE r rorRet = ERROR.ACCESS.DENIED; 
pSLttnfo->pStorageUnit->Unlock (ev, pSUInfc->key); 
ReleaseName (pSUInfo); 
return (ERRQR.FILE NOT FOUND); 

} 

ReleaseName (pSUInfo); 
pmmioinfo">aulInfo[i] * 0; 
return (0); 


Listing 5 Open processing example. (Continued on page 62 j 


> else if ( pmtnioinfo->ulflags ft HHI0.CREATE ) { 

// Remove the Property / ValueType if there 

if (pSUInfo->pStorageUnit->Eiists (ev, 

pSUInfo->szPropertyName * 
pSUlnfo->szYalueType, 

0 )) { 

p5UInfo->key = pStUnfO">pStorageUnit->Lock (ev, 0); 
if (!IsException(ev)} { 

pSUInf0->pStorageUnit->Focus(ev, 
pSUInf0->szP rope rty N a me, 
kODPosFirstSib, 
pSUln f o-> sz ValueT y pe, 

0 , 

kODPosFirstSib); 
if (!IsException(ev)] { 

pSUInfo->pSto rageUnit->Remo v e (ev); 

} 

} 

pSUInfo->pStorageUnit->Unlock (ev, pSUInfo->key); 


// now create it new property 

pSUInfo->key = pSUInfo->pStorageUnit->Lock (ev, 0); 
if (!IsException(ev)) { 

pSUInfo-> pStorageUnit-> AddP rope rty(ev, 
pSUInfo->szPropertyName); 
if OlsExceptianCev)) { 

pSUInfo->pStorageUnit->AddValue (ev, 
pSUInfo->szValueType); 
if (!IsException(ev» { 

pSUIhfo->pStorageUnit->Urlock (ev, pSUInfo->key); 

> else { 

pSUXnfo->pStorageUnit->Unlock (ev, pSUlnfo->key); 
ReleaseName (pSUInfo); 
pjnmioin f q->u!E r ro rRet = ERROR_IN Y A LID _ N AHE; 
return (ERROR.MALIDJAME); 

> 

} else { 

pSUln f o->pSto rageUnit->Unlock (e v, pSUln fo-> ke y); 
ReleaseName (pSUInfo); 
pmmioinfc->ul£rrorRet - ERROR.INVALID.NAME; 
return (ERROR.INVALID NAME); 

} 

> else { 

pSUInfo->pStorageUnit->Unlock (ev, pSUln f o-> key); 

Relea seN ame (pSUInfo); 

pmmioinfo->ulErrorRet = ERROR_INVALID_NAME; 

return (ERROR.INVALID.NAHE); 


pmmioinfo->liogicalFlLePos = 0; 

} 615e i /* standard open */ 

pSUInfo->key = pSUInf0’>pStorageUnit->lock (ev, 0); 
if OlsExceptiontev)} { 

if (pSUInfo->pStorageUnit->Exists (ev, 

pSUInf o->szPrope rty Name, 
pSUInfo->sz¥alueType, 

0 )) { 

pSUln f o->p5to rageUnit->Focus(ev, 
pSUInfo->$zP rope rty Na me, 
kOOPosFirstSib, 
pSUInf o->szV alu ely pe, 

0 , 

kODPosFirstSib); 
if {!I$Exception(ev}} { 

size = pSUlrfo->pStorageUnit->GetSize(ev); 
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} 

if (size 


} 


if (pnmioinfo->ulFlags ft NNIO_APPEND) { 
pwnioinfo->lLogicalFilePos * size; 

} else { // normal open 

pmmioinfo*>lLogicalFilePos = 0; 

> 


pSUInfo->pStorageUnit->Unlock (ev, pSUInfo->key); 
} else { 

pSUInfo->pStorageUnit->Unlock (ev, pSUInfo->key); 
ReleaseName (pSUInfo); 

pmmioinfo->ulErrorRet * ERROR.FHE.NOT.FOUND; 
return (ERROR.FHE NOT FOUND); 

> 

} else { 

pSUInfo->pStorageUnit->Unlock (ev, p5UInfo->key); 
ReleaseName (pSUInfo); 

pa«tioinfo->ulErrorRet « ERROR.FHE.NOT.FOUND; 
return (ERR0R.FHE.N0T FOUND); 

} 

else { 

pSUInf o->pStorageUnit->Unlock (ev, pSUInfo->key); 
ReleaseName (pSUInfo); 

p«nioinfo->ulErrorRet = ERROR.ACCESS.DENIED; 
return (ERROR.ACCESS.DENIED); 


0 ) { 

// This will cause the audio wed to call us back 
again with a create 

pmnuoinfo->ulErrorRet = ERROR.FHE.NOT.FOUND ; 
ReleaseName (pSUInfo); 
return (ERROR.FHE.NOT.FOUND); 


return (0); 

} 

Listing 5. Open processing example. (Continued from page 61) 


pointer is stored in the aullnfotl] field 
of the NHI0INF0 structure, which is 
passed to the lO Procedure on each 
subsequent call by the MMIO 
Manager. 

During the processing of HHI0M.0PEN 
the open flags may contain, 
HMI0.DELETE, which indicates that the 
Value should be deleted. This is done 
by calling Lock(), ExistsO, FocusO, Re- 
move(), and UnlockO on the ODStorageUnit 
object. These are SOM 2.x 1DL meth¬ 
ods, and it is very important to always 
check the Environment for exceptions 
if they occurred, so that they can be 
translated to MMIO Errors and re¬ 
turned properly. The common errors 
here are ERROR.ACCESS.DENIED or ER¬ 
ROR.FHE.NOT.FOUND. 

MNIO.CREATE may also be passed as 
an open flag. In this case, a new 
Property/Value pair should be cre¬ 
ated by calling Lock; ExistsO to deter¬ 
mine if it already exists; and FocusO, 
AddPropertyO, AddValueO, and UnLockO. 
ERROR.INVALID.NAME or ERROR.ACCESS.DENIED 
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is returned in the 
ulErrorRet field if 
something then fails 
here. 

The MHI0H.0PEN 
could also be a stan¬ 
dard open, with or 
without the HNI0.AP- 
PEND flag. If the 
HMI0.APPEND flag is 
set, the logical file 
position should be 
initialized to the 
length, otherwise to 
0. The length of a 
particular Focus-ed 
Value can be deter¬ 
mined with the Get- 
SizeO method. The 
lLogicalFilePos field 
of the MMI0INF0 struc¬ 
ture defines the file 
position. 

One anomaly 
occurs during open 
processing: if the IO 
Procedure is asked 
to open a Property/ 
Value pair that ex¬ 
ists but has zero 
length, it should be 
treated as if the 
property doesn't 
exist. All multime¬ 
dia files have head¬ 
ers. If the mmioGet- 
HeaderO fails, the 
subsystems check 
for Extended Attri¬ 
butes to determine if the file is a tem¬ 
plate. Since Extended Attributes are 
not supported by any Storage System 
IO Procedures, the File Format IO 
Procedures directly use file system 
APIs. By treating a zero length 
Property as if it doesn't exist, the mul¬ 
timedia File Format IO Procedures will 
create it and initialize it properly. 

Listing 5 shows how the Open 
processing would be implemented. 

BASIC READ/WRITE PROCESSING 

The remaining IO functions are more 
straightforward. HHION.READ is pro¬ 
cessed by calling Lock(), FocusO, 
SetOffsetO to the most recent seek off¬ 
set, GetValueO to get block of data, and 
UnlockO. 

HNI0M.WRITE is processed by calling 
Lock(), FocusO, SetOffsetO to the most 
recent seek offset, SetValueO to set the 
block of data, and UnlockO. On the 
write, it is important to check the bytes 
actually written, and if it is less than 
the write attempt, return the MMI0- 
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ERR.CANNOTWRITE error. This indicates 
that the disk is full. 

HMI0M.SEEK just updates the 
lLogicalFilePos field in the MMI0INF0 
structure. This offset will be used on 
the next read, write, or seek operation. 

HMI0H.CL0SE just releases the in¬ 
stance data structure. 

Because this IO Procedure uses a 
pointer in the media object name, it's 
probably not a good idea for the appli- 
cation to store these media object 
names persistently anywhere. Also, 
since only your application has knowl¬ 
edge of this IO Procedures media¬ 
naming syntax, it's a good idea to reg¬ 
ister the IO Procedure only for the 
application's process and not for the 
whole system. This is easily done by 
using the nwnioInstalllOProcO function 
of MMIO. 

With a Storage System IO 
Procedure that makes OpenDoc 
Storage Unit calls, Multimedia data 
can be transparently integrated into 
most any OpenDoc component and 
embedded into any OpenDoc aware 
application. This gives application de¬ 
velopers much more flexibility and 
more opportunity to combine their 
multimedia-enabled software with 
other software components to yield 
unique solutions. 

ADVANCED TOPICS 

Another topic to consider when de¬ 
signing a Storage System IO Procedure 
for OpenDoc is whether the storage 
unit needs to be accessed by more than 
one process. For example, drag-and- 
drop or clipboard support in the 
OpenDoc component handler may 
want to avoid copying large amounts 
of data, such as a video or large audio 
annotation, so it might choose to pass 
a file name or media object name 
where the data can be accessed by the 
receiver. This problem would require 
letting the owner process service re¬ 
quests to access the data by using 
some custom mechanism like PM mes¬ 
sage passing between processes or 
possibly using Distributed SOM 
(DSOM) to access the object. If multi¬ 
ple processes are involved, its a good 
idea to include the process ID of the 
process that owns the ODStorageUnit ob¬ 
ject in the name of the media object. 
Allowing only read access would 
probably be a good idea from another 
process. 

Another issue is undo/redo sup¬ 
port in the OpenDoc component han¬ 
dler. Typically, before chaining some 
internal data of a component, the han- 




dler will put the old data into an undo 
stack, so that the modification can be 
undone at a later point in time. If you 
are using the multimedia subsystem to 
directly put data into the storage unit, 
the handler will want to know just be¬ 
fore the data is written that the data is 
going to be modified, allowing it to 
create an undo record. Large amounts 
of data are a bit problematic for undo, 
however, the DOStorageUnit IO Pro¬ 
cedure could provide a callback to the 
component handler when HHIOM.WRITE 
or 11IQMJPEN with 1110.CREATE is called, 

OTHER WAYS 

Of course, other ways do exist to inte¬ 
grate multimedia data into OpenDoc 
component handlers, OS/2 provides 
basic multimedia component handlers 
for audio, video, image, and M1DL 
These handlers provide some of the 
more common functions that a user 
would want to do with sampled audio, 
digitized video, scanned images, or 
computerized music. These compo¬ 
nent handlers could be embedded into 
a more specialized component pro¬ 
grammatically as well as by the users, 
giving them a common interface for 
dealing with these data types and free¬ 
ing up the programming to provide 
more of what they are good at. 


Scott Broussard is an advisory programmer 
in OS/2 multimedia development and is 
responsible for designing and developing mul¬ 
timedia user interfaces. He is currently the 
lead architect for the OS/2 Multimedia 
Workplace Shell/OpenDoc team. Broussard 
can be reached at $coti_Broussard@bocara- 
tonJbm.com. 
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The Automated Test Facility was built 
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Buyers Guide 




The staff of OS/2 Developer put together this special section to guide you through the 
various client/server tools. The products in this guide are based on surveys sent to ven¬ 
dors; they are provided as a service to you and are free to vendors. These listings do not 
represent an endorsement by OS/2 Developer. Although every effort has been made to 
ensure accuracy, we do not assume responsibility for any errors or omissions. 


Client/ Server 
Buyers Guide 

ANDERSEN CONSULTING S 
FOUNDATION SOFTWARE 
ORGA NiZA TiON Circle No. 101 

Foundation for Cooperative Processing (FCP) al¬ 
lows for asynchronous message routing be¬ 
tween client and server systems. FCP is a 
second-generation client/server solution that 
allows organizations to develop and deploy 
enterprise-wide, mission-critical applica¬ 
tions. FCP features the Rapid Application 
Builder (RAB), a design approach that eases 
the process for developing client/server sys¬ 
tems; Foundation Construction, which gen¬ 
erates code for client /server applications 
from objects stored in the repository; and 
Foundation Production, which includes pre¬ 
sentation services, distribution services, and 
applications services. The current release, 
FCP 2,4, provides additional capabilities, 
such as increased ease-of-use through im¬ 
proved online documentation, tutorials, and 
migration utilities; increased openness 
through user-defined object types, and a 
published information model. New produc¬ 
tivity features, such as window control and 
WYSIWYG enhancements; extended archi¬ 
tecture for ultrahigh performance (NT clients 
and an HP-UX gateway to CICS); and new 
support for OS/2 32-bit, SUN Solaris for 
SPARC (server), DEC OSF/1 for Alpha AXP 
(server), and IBM AIX for RS/6Q0Q (server) 
are also included 

Andersen Consulting's Foundation 
Software Organization, 69 W. Washington, 
Chicago, 111. 60602 (312) 507-3322, fax (312) 
507-0594, 

ASPECT COMPUTING PTY L TO . Circle No. 102 
LANSA/CS400 develops multilingual cli¬ 
ent/server applications using a single, easy- 
to-learn skill set. Its comprehensive OS/2 de¬ 
velopment environment includes compile, 
test, debug, and task-tracking facilities. A 


Tools 


centralized LANSA repository holds busi¬ 
ness rules, triggers, and stored procedures 
and ensures data integrity is maintained. 
Finished applications have access to data res¬ 
ident on DB2/40Q, DB2/2 databases, or via 
ODBC and DRDA interfaces. 

Aspect Computing Pty Ltd., Level 11,122 
Arthur St., North Sydney, NSW, Australia, 
2060,61 -2-9957-3188," fax 61 -2-9957-2657. 

BRIGHTWARE Circle No . 103 

ART*Enterprise is a client/server application 
development tool that offers rules, case- 
based retrieval, and advanced object-ori¬ 
ented programming capabilities for building 
intelligent applications. 

Brightware, 101 Rowland Wy., Ste. 310, 
Novato, Calif, 94945, (415) 899-9070, fax (415) 
899-9080. 

CGI SYSTEMS INC. Circle No. 104 

PACBASE/CS , is an integrated application de¬ 
velopment tool that includes support for 
client/server development and legacy sys¬ 
tems. With an interactive multiuser reposi¬ 
tory driving the process, PACBASE/CS can 
generate complete applications for over 45 
target environments, including IBM main¬ 
frames (MVS/VSE), midrange (S/38, AS/ 
400, RS6000), and PCs (OS/2, MS-DOS, 
UNIX). IBM has selected CGI's PAC¬ 
BASE/CS family of products as its premier I- 
CASE solution, CGI's integrated application 
development products operate on main¬ 
frames, LANs, and UNIX machines. 

CGI Systems, Inc, 1 Blue Hill Plaza, 
Pearl River, N.Y. 10965, (914) 735-5030, fax 
(914) 735-223L 

CIMTECH Circle No. 105 

CIMVIEW is designed for technical manage¬ 
ment and supervision applications. Based on 
a distributed real-time and archives database, 


64 


OS/2 DEVELOPER 







it gathers information from all processing 
equipment (PLCs, DCS, measurement, and 
so on), in this way, CIMVIEW allows instal¬ 
lation managers to completely manage their 
entire application, either for the daily follow¬ 
up and control, or for long-term manage¬ 
ment such as modeling and quality control 

Cimtech, 20 Rue de LTndustrie, 
Nivelles, Belgium 1400, 32-067-883666, fax 
32-067-883688. 

CLIENT/SERVER LABS Circle No. 106 

Reference Performance Mark Benchmark 
(RPMark) is based on industry standard 
workloads. The RPMark benchmark is a 
comprehensive performance evaluation de¬ 
signed specifically for client/server environ¬ 
ments. It is made up of three workloads run¬ 
ning concurrently. The components include: 
Online Transaction Processing (OLTP), 
which uses client/server transaction-ori¬ 
ented applications, is based on a subset of 
the TPC-IP benchmark, and is modified to 
run in a true client/server environment; 
Decision Support, which PC clients use to 
initiate query-intensive applications on the 
server using Open Database Connectivity 
(ODBC) calls; and File-Serving/Office 
Automation Services, based on a subset of 
the Business Application Performance Corp. 
(BAPCo) benchmark, for personal productiv¬ 
ity applications. The RPMark designation 
will be given to client/server components 
undergoing the performance evaluation. 

Client/Server Labs, 8601 Dunwoody PL, 
Ste. 332, Atlanta, Ga. 30350-2509, (770) 552- 
3645, fax (770) 993-4667, 

COMPUWARE CORP. Circle No . 107 

Uniface 6.Q uses a model drama approach to 
enable developers to build enterprise 
client/server applications scalability and 
portability. Uniface 6.0 is based on four prin¬ 
ciples: model-driven development for high 
productivity and portability, graphical ob¬ 
ject-based environment for visual and easy- 
to-use applications, technology-independent 
deployment for scalability and flexibility, 
and team development for group productiv¬ 
ity. Uniface 6.0 is a native OS/2 develop¬ 
ment system that supports all platforms, op¬ 
erating systems, GUIs and character mode, 
data sources, networks, and CASE tools. 
Uniface 6.0 supports DB2/2, DB2/6000, 
DDCS, IBM Lan services, and Workplace 
Shell. 

Compuware Corp., 31440 Northwestern 


Hwy, Michigan, Ill. 48334-2546, (810) 737- 
7119, fax (810)737-7108. 

ERGIE S.A. Circle No. 108 

TP Toots/2 is an engine that uses services 
modules for client/server, teleprocessing, 
and general purposes such as PM screen dy¬ 
namic and static management, printing mod¬ 
els, data access, and communications. Its 
method is based on rules interpretation, 
which can be handled by customers, regard¬ 
less of their development knowledge. 

ERGIE S.A., 1 rue Nicolas Copernic, 
Arles, 13200. 

GA TEW A Y SYSTEMS CORP . Circle No. 109 

Synergist is a cooperative processing cli¬ 
ent/server development tool that integrates 
PCs with host computers. It is used to de¬ 
velop online, transactional-based applica¬ 
tions. All applications execute on the PC, ac¬ 
cessing a host and/or PC database. Major 
modules include Dictionary, Forms Gen¬ 
erator, and Forms Compiler. Features in¬ 
clude pop-up windows, lists, tables, condi¬ 
tional displays, and redefinable function 
keys. 

Gateway Systems Corp., 4660 S. 
Hagadorn, Ste. 110, East Lansing, Mich. 
48823, (517) 337-8960, fax( 517) 337-2868. 

GLOBAL VILLAGE 

C0MMUNICA TION Circle No. 110 

FaxWorks API Toolkit provides client/server 
fax services to applications on OS/2. 
Applications that you write using API will 
work with ail fax hardware that is supported 
by the FaxWorks OS/2 products. The API 
supports both spooled and current call send¬ 
ing and receiving, status monitoring, format 
conversion, custom dialing, and LAN rout¬ 
ing and notification. This product includes 
the Fax Printer Driver Toolkit. 

Global Village Communication, 1110 
Northchase Pkwy, Ste. 150, Marietta, Ga, 
30067, (404) 984-8088, fax ( 404)984-9956. 

GREAT LAKES SOFTWARE Circle No. Ill 

GLS-Presto is an integrated development en¬ 
vironment that lets developers visually cre¬ 
ate client/server and stand-alone applica¬ 
tions, which are executable under both OS/2 
and Windows. Presto supports application 
development in Cobol, C, and C++, 

Great Lakes Software, 810 East 
Coliseum Blvd., Ste. 109, Fort Wayne, Ind. 
46805, (219) 481-5809, fax (219) 455-3275. 
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HOCKWARE Circle No. 112 

VisPro/Reports 1.0 is a REXX-enabled re¬ 
port writer for VisPro/REXX, VX 
REXX, and OS/2 REXX. It allows you 
to print reports including invoices, 
form letters, personnel reports, and fi¬ 
nancial reports. A variety of Avery™ 
labels are supported, allowing the user 
to print addresses and other labels. A 
CUA'91 style WYSIWYG report de¬ 
signer allows the user to include busi¬ 
ness graphics, photographs, calculated 
fields, multiline text, and other cos¬ 
metic shapes. Apply numerous object 
attributes, including 16 million colors, 
OS/2 ATM fonts, fill patterns, and 
drop shadows. 

HockWare, 315 North Academy 
St, Ste. 100, Cary, N.C. 27513, (919) 
380-0616, fax (919) 380-0757. 

IBM CORF. Circle No. IIS 

Paperless Manufacturing Workplace, an 

OS/2 client/server application, lets 
you create, maintain, distribute, and 
display work instructions and associ¬ 
ated work orders. Multimedia work 
instructions are organized so a user 
views pages of information, displaying 
the items needed to do the job at hand 
using media best suited for the task. 

PlantWorks is a distributed cli¬ 
ent/server application development 
and processing tool for supervisory 
control and data acquisition (SCADA). 
It uses the OS/2 Presentation Manager 
interface and conforms to SAA stan¬ 
dards. PlantWorks products use the fa¬ 
cilities and functions of the Distributed 
Automation Editions systems enabler 
to provide access to the communica¬ 
tions and device resources. 

IBM Corp., 1000 51st St,, Boca 
Raton, Fla. 33431, (407) 443-9019, fax 
(4D7) 443-6824, 

IBM CORP. Circle No. 114 

I Usual Gen Developer provides the defin¬ 
ition and test of complete applications 
for client/server, including OS/2 and 
Windows GUI clients and local and re¬ 
mote servers. VisualGen is a visual 
programming solution for developing 
client/server applications. The prod¬ 
uct includes visual construction of GUI 
client applications and a robust 4GL 
for building remote and server appli¬ 
cations. Clients are supported on OS/2 
and Windows. VisualGen exploits the 
DB2 and CICS families for data inte¬ 
gration and high-volume transaction 
processing. 

IBM Corp., Software Solutions 
Division, 11000 Regency Pkwy., Bldg. 
671/3ba, Cary, N.C. 27511, (919) 469- 
6329, fax (919) 469-4410. 


INTERSOL V INC. Circle No. 115 

APS/PC for OS/2 enables rapid develop¬ 
ment of client/server and traditional 
production applications for OS/2 with 
Oracle, Microsoft/Sybase SQL Server, 
DB2/2, DB2, DB2/6000, SQL/400, 
IMS/DM, VSAM, and OS/40Q native 
data file sources. Client/server appli¬ 
cations are generated using database 
servers, gateways, or APPC-connected 
server programs—100% generated by 
APS. APS provides an open, extensi¬ 
ble, and customizable development 
environment with no proprietary lan¬ 
guage or runtime components. APS of¬ 
fers a solution for both new develop¬ 
ment and existing-system enhance¬ 
ment, for both client/server and tradi¬ 
tional systems, across many produc¬ 
tion platforms. 

Intersolv Inc., 1700 N.W, 167th PL, 
Beaverton, Ore. 97006, (800) 547-4000, 
fax (301) 838-5064. 

ISAINFORMATIONS- 

SYSTEME GMBH Circle No . 116 

ISA Dialog Manager User Interface 
Management System supports all 
major window systems and alphanu¬ 
meric terminals. A client/server com- 
ponent allows the distribution of ap¬ 
plication and dialog in heterogeneous 
environments. 

ISA lnformationssysteme GmbH, 
Azenbergstrasse, 35 Stuttgart, D-70174, 
49-711-227690, fax 49-711-22769-19. 

INTELLIGENT 

ENVIRONMENTS INC Circle No. 117 
A M/Harvest is a project manager and 
documentation tool that reduces the 
cost of large-scale client/server appli¬ 
cation development projects. It offers 
teams of programmers the capabilities 
for change-management and "where- 
used" impact analysis—streamlining 
application design, construction, and 
modification. AM/Harvest reads and 
analyzes program listings, stores the 
information in a repository, and auto¬ 
matically documents the application. It 
enables previously developed code to 
be "harvested" for better maintenance 
and for reuse in new applications. 
AM/Harvest generates complete on¬ 
line system documentation in easy-to- 
use hypertext format (OS/2.INF files). 
All references to variables, procedures, 
functions, and modules are hot-linked 
to details on the usage of each entity. 

AM/Sofo uses a highly visual, in¬ 
teractive interface to let developers 
produce client/server applications. 
AM/Solo is designed to be used by 
conventional as well as specialist pro¬ 
grammers. Its aim is to hide the corrv- 
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plexity of graphical user interfaces, 
multitasking, and object orientation 
but deliver their power. 

Intelligent Environments Inc., 2 
Highwood Dr., Tew r ksburv, Mass. 
01876, (617) 272-9700. 

KALEIDA LABS INC. Circle No. 118 

ScriptX Language Kit (SLK) 1.0 provides 
technically sophisticated and experi¬ 
enced multimedia content and tool de¬ 
velopers early access to the power and 
flexibility of the ScriptX Language and 
Class Library. The language is fully 
object-oriented, multithreaded, device 
independent, C-extenslble, and incre¬ 
mentally compiled. The product also 
features multiple inheritance, dynamic 
binding, and built-in data searching. 
Class Library features include: clocks 
and players, two-dimensional graphics 
and text; mod el-presenter-controller, 
data management, and user interface 
or interaction. 

Kaleida Labs Inc., 1055-B Joaquin 
Rd., Mountain View, Calif. 94043, (415) 
335-2098, fax (415) 335-2097. 

KASES YSTEMS INC. Circle No . 11S 

KASE: VIP for OS/2 is a knowledge-as¬ 
sisted visual design and code-genera¬ 
tion tool for building GUI and 
client/server applications. Use the vi¬ 
sual designers to create OS/2 objects 
and then associate them with business 
logic and data. In a client/server envi¬ 
ronment, this process produces a 
seamless integration with SQL data¬ 
bases or CICS transactions. KASE: VIP 
then generates the application source 
code in C. 

KASE:VIP is a visual design and 
standard language code-generation 
tool for developing business-critical 
client/server applications for OS/2. 

KASE Systems Inc,, 1 Meca Wy., 
Ste. 150, Noreross, Ga. 30093, (404) 
564-5696, fax (404) 564-5679. 

LANWORKS 

TECHNOLOGIES INC Circle No. 120 
BootWare Manager is a fully integrated 
Windows-based NetWare LAN man¬ 
agement console. It works with 
BootWare or BootWarePLUS to pro¬ 
vide centralized boot management so¬ 
lutions. Administrators can create, 
maintain, and update boot image files 
on the server for PCs. BootWare 
Manager also provides image and 
global diagnostics with flexible sorting 
and reporting functions. 

Lanworks Technologies Inc., 2425 
Skymaxk Ave w Mississaugia, Onfc. 
L4W 4Y6, Canada (905) 238-5528, fax 
(905) 238-9407. 


MOZART SYSTEMS CORP Circle A to. 121 
Mozart , a graphical user interface and 
software development tool, helps busi¬ 
nesses realize immediate client/server 
benefits from legacy applications. 
Applications may be developed and 
run without recompilation or modifi¬ 
cation, Use Mozart to renovate legacy 
applications to achieve client/server 
benefits quickly, 

Mozart Systems Corp., 1350 
Bayshore Hwy, Ste, 630 , Burlingame, 
Calif. 94010, (415) 340-1588, fax <415) 
340-1648. 

NETRON INC. Circle No. 122 

Netron Fusion is a systems delivery so¬ 
lution for building large-scale applica¬ 
tions for mainframe, midrange, and 
client/server environments. Combined 
with an integrated toolset, Netron 
Fusion uses a component approach to 
software reuse that has been proven to 
produce core systems 70% faster than 
the industry average. It features an 
open, scalable architecture for maxi¬ 
mum flexibility and complete control 
over the development process. It also 
offers template programs for prototyp¬ 
ing, consisting of program specifica¬ 
tions, class libraries, screens, and sam¬ 
ple files that developers can use 
immediately. 

Netron Inc, 99 St Regis Cres* N., 
Toronto, Ont M3J 1Y9, Canada (416) 
636-8333, fax ( 416) 636-4847. 

OPEN SOFTWARE 

ASSOCfA TES INC. Circle No. 123 

OpenUI provides a way to develop user 
interfaces for client/server and stand¬ 
alone applications. It drives the same 
interface on all character terminals 
using a standard GUI, without addi¬ 
tional development. A user interface 
developed on one GUI/platform can 
be migrated without redevelopment to 
any other GUI/platform, maintaining 
the native look and feel. 

Open Software Associates Inc., 20 
Trafalgar $q., Ste. 414, Nashua, N.H* 
03063, (603) 866-4330, fax (603) 598- 
6877. 

PARCPIACE 

SYSTEMS INC Circle No. 124 

Visual Works is a client /server tool for 
building portable applications using 
object-oriented technology. A Data¬ 
base Applications Creator is included 
for rapid application development. 
Applications developed are instantly 
portable across multiple platforms, are 
scalable across the enterprise, and can 
have their functionality distributed be¬ 
tween both client and servers* 


ParcPlace Systems Inc., 999 East 
Arques Ave*, Sunnyvale, Calif* 94086- 
4593, (408) 481-9090, fax( 408) 481- 
0214. 

PR0T0S0FT Circle No. 125 

Paradigm Plus 3.0 is an application de¬ 
velopment tool that supports 
Enterprise Component Modeling 
(ECM), code generation, and reverse 
engineering. Using ECM, companies 
can identify business requirements, 
model reusable application compo¬ 
nents, and manage systems over the 
long term* Paradigm Plus makes ECM 
possible through its support for lead¬ 
ing object-oriented methodologies; in¬ 
corporation of an object repository for 
teams of concurrent users; and auto¬ 
matic synchronization of models, 
source code, and documentation. 
Using methods such as OMT, Fusion, 
Martin/Odell OOIE, and others ex¬ 
tended to support Jacobson's Use Case 
modeling. Paradigm Hus automates 
all leading object-oriented methods in 
a single solution. Automatic genera¬ 
tion of C, C++, Smalltalk, Ada, and 
ODBMS and RDBMS schema defini¬ 
tions increases productivity. Built-in 
consistency checks ensure quality and 
reduce maintenance costs, while a 
script language allows custom report¬ 
ing, checking, and code generation* 
Reverse engineering utilities preserve 
your investment in legacy software. 
Online hypertext help, thorough docu¬ 
mentation, and hands-on tool training 
give your team a quick start. Paradigm 
Plus is available on most popular 
UNIX and PC platforms. 

ProtoSoft, 17629 El Camino Real, 
Mail Stop 400, Houston, Tex. 77058, 
(713) 480-3233, fax (713) 480-6606. 

SYBASE INC Circle No. 126 

Open Server ™ 10.0 is a programmable, 
network-independent server for creat¬ 
ing high-performance client/server 
applications. It allows client applica¬ 
tions to access diverse data, including 
flat files, real-time data, e-mail, and re¬ 
lational data. 

Sybase Inc*, 6475 Christie Ave*, 
Emeryville, Calif* 94608, (510) 922- 
8547, fax (510) 922-4747* 

SYNQNINC Circle No .127 

Synon Client/Server Generator for OS/2 

enables application developers to re¬ 
generate Synon/2E design models to 
run on OS/2 and Windows 3*1 plat¬ 
forms. Synon/CSG delivers distrib¬ 
uted function C/S applications with 
client processing in Microfocus 
COBOL/2, OS/2 help native commu¬ 


nication handling while the AS/400 
server stores DB2/400 database. 

Synon Inc., 1100 Larkspur 
Landing Crle., Larkspur, Calif* 94939, 
(415) 461-5000, fax (415) 461-2171. 



TECHBRIDGE 

TECHNOLOGY Circle No. 128 

TechBridge Builder for OS/2 ; a visual de¬ 
velopment tool, simplifies creating ob¬ 
ject-oriented client/server applications 
through reuse of legacy resources. 
Developers can paint any GUI, includ¬ 
ing drag-and-drop, in a visual manner 
with no coding- TechBridge Builder 
also offers a COBOL-based scripting 
language for procedural code attached 
to GUI events. Developers need not 
know Smalltalk, C++, or SQL. 

TechBridge Visual Objects is a 
client/server application development 
tool that simplifies the creation of ob¬ 
ject-oriented applications. Powerful vi¬ 
sual designers can paint any type of 
GUI, including a drag-and-drop 
OOUI, with point-and-click connection 
to SQL and xbase databases. Little or 
no coding is required. Also supported 
are: a C-based scripting language with 
a source debugger and incremental 
compiler for iterative Rapid App¬ 
lication Development; team support 
via PVCS interface. 

TechBridge Technology, 5001 
Yonge St., Ste. 1301, North York, Ont. 
M2N 6P6, Canada (416) 222-8998, fax 
(416) 222-0168* 


VMARK SOFTWARE INC. Circle No. 123 
ENFIN Object Studio is a family of ob¬ 
ject-oriented products for developing 
client/server applications based on 
business objects* These applications 
are scalable, maintainable, and adapt¬ 
able to changing processes. ENFIN 
provides a suite of visual tools for de¬ 
veloping and deploying Windows and 
OS/2 applications* It supports a vari¬ 
ety of architectures with a range of 
connectivity options. 

ESL Continuity is an integrated, 
event-driven, 4GL-based visual tool 
for developing robust production 
client/server applications for Win¬ 
dows and OS/2. It translates external 
source format code from any CASE 
vendor supporting ESF, including 
IBM, Texas Instruments, Knowledge- 
Ware, and Bachman, into ESL lan¬ 
guage source code* 

ESL Workbench is an integrated de¬ 
velopment environment for rapidly 
creating robust production client/ 
server applications. The application's 
visual tools for design, debugging, and 
testing are all grounded in the event- 
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driven ESL development language. 
Also included is ESL DB/Assist, a 
graphical point-and-click tool for gen¬ 
erating the SQL portion of your 
client/server application. 

Synchronicity Object Studio is a 
family of object-oriented products for 
developing client/server applications 
based on business objects. These ap¬ 
plications are scalable, maintainable, 
and rapidly adaptable to changing 
business processes. Synchronicity inte¬ 
grates the design, assembly, and reuse 
of high-level business objects, ensur¬ 
ing that the company's business, the 
system design, and the application al¬ 
ways remain synchronized. Synch¬ 
ronicity is bidirectionally integrated 
with ENFIM 

TeamBuilder Object Studio is a fam¬ 
ily of object-oriented products for de¬ 
veloping client/server applications 
based on business objects. These appli¬ 
cations are scalable, maintainable and 
rapidly adaptable to changing busi¬ 
ness processes. TeamBuilder enables a 
development team to jointly build ob¬ 
ject-oriented client/server applica¬ 
tions. Developers can reuse and build 
upon each other's objects. 

VMARK Software Inc,, 50 
Washington St., Westboro, Mass. 


01581, (508) 366-3888, fax (508) 366- 
3669. 

WATCQM Circle No, 130 

VX*REXX Client/Server Edition is a visual 
development environment for creating 
OS/2 GUI applications. It includes 
powerful connection, query, and chart 
objects that access, build, and connect 
databases, manipulate data, and chart 
the results quickly and easily, 

Watcom, 415 Phillip St., Waterloo, 
Ont N2L 3X2, Canada, (519) 886-3700, 
fax (519) 747-4971, 

XVT SOFTWARE INC Circle No. t3t 
XVT Development Solution for C++ 
(0SC++J is a true application frame¬ 
work with powerful features such as 
field validation, drag and drop, envi¬ 
ronment inheritance, nested views, 
geometry management, imaging, and 
the completely integrated rogue wave 
data structures, Its visual application 
builder is used for the entire applica¬ 
tion development life cycle, from de¬ 
sign to layout through final application 
building. DSC++ offers complete 
portability to all popular GUIs. 

XVT Software Inc., 4900 Pearl East 
Crle., Boulder, Colo. 80301, (303) 545- 
3150, fax (303) 443-0969. 


YA M. COMPUTERS 

(1982) LTD, Circle No. 132 

OpenWin is an open client/server, 4GL 
GUI, multiple database, and multiplat¬ 
form front-end development tool, 
which applies a distributed applica¬ 
tions client/server paradigm. Open- 
Win is targeted to help developers de¬ 
sign front-end user interface com¬ 
ponents such as screens, windows, 
flow-control, and field edits. It inter¬ 
faces GUIs such as OS/2, Windows, 
and others, while adapting the best of 
each. OpenWin enables portability of 
applications across platforms by using 
local and global dictionaries on LAN 
servers of differing platforms to simul¬ 
taneously interface a wide range of 
DBMS and RDBMS products. Open¬ 
Win has an any-to-any client/server 
ability, with memory and resource 
sharing, enabling real cooperative pro¬ 
cessing. Its applications can be used as 
clients, servers, or both. Using a 
client/server paradigm to access data¬ 
base engines and user-defined servers, 
OpenWin is an easy-to-use tool that fa¬ 
cilitates modular growth and reduced 
costs. 

Y.A.M, Computers (1982) Ltd., 2 
Hadar St, Herzeliya 46290, Israel, 972- 
9-589714, fax 972-9-507317. 



Back Issues 

To order your back issues of 
OS/2 Developer^ call now: 


ADD-bJANT-OSE 

(aOD-TEb-Ab72 

or write to: 

GS/B Developeri P- 0- Box ID?^ 
Skokie! IL bGDTb-fltm 

Issues are plus *2*^5 shipping and handling. 

All orders aust be prepaid- 
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JBA Guidelines. 

The Application Generator for people who use C++ 
AND those who don’t want to. 




Database Connectivity 

Access to simultaneous, mul¬ 
tiple databases is transparent 
through JOT Supported data¬ 
bases include: DB2, DB2/2, 

DB2/400, DB2/6000, Oracle. 
Lotus Notes Server, and 20 
more through native ODBC 


Network Connectivity 


An intuitive and natural inter- 
face for the direct manipulation 
of on-screen design tor OS/2 
and Windows, with over 30 
powerful controls for the pro¬ 
fessional developer. Includes all 
the standard controls plus 
Gauge, Button Bar, Grid and 
Graph. 

The Repository 


The 
Guidelines 
Model 


The repository supports and 
surrounds the entire program¬ 
ming environment with the 
facilities for teamwork develop¬ 
ment. Databases can be created 
on multiple hosts from a single 
definition. Data definitions can 
be directly imported into a GUI 
program. 


Constructed on a six-segment development model, 
JBA Guidelines has been built to answer the needs of 
developers who wish to produce software capable of 
addressing heterogeneous computer networks from 
one single development point. 

Guidelines is available in option packs to serve the 
needs of single PC developers right up to enter prise- 
wide development teams. 


Logic, Language, and 

A platform-independent high- 
level language. JOT combines 
the RAD features of a 4GL 
with the generation of native 
code (C++ and RPG) for the 
Client AND Server, Existing 
legacy 3GL code can be 
directly interfaced. And 
CORBA-compliant objects can 
replace logic at any time in the 
future. 


Compiler 


Graphical User Interface 


By mixing the connectivity com¬ 
ponents as required, applications 
can be built as thin clients, thick 
client/server with application 
partitioning, and fully distributed 
Object-Oriented, Supported hosts 
are: OS/2, AS/400, UNIX, MVS, 


Object Messaging 

The Message layer is fully 
compatible with all current 
Object Request Broker (ORB) 
standards. JOT verbs provide a 
single interface to current 
technology and the OO of 
tomorrow. Guidelines provides 
CORBA IDL and IBM SOM 
support. 


Call for an evaluation CD-ROM . 



All trademarks arc ihe properly gf their respective owners, 
©JBA 


Available from Indelible Blue 
J-800-776-8284 

JBA International 
1-800 JBA-INTL 
In Europe: (44) 1789-400212 
Internet: http://www.jba.co.uk 
CompuServe: Go Guidelines 
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Product Watch 

The staff of OS/2 Developer has put together this special section to guide you through 
the new products. These listings do not represent an endorsement by OS/2 Developer, 
Although every effort has been made to ensure accuracy, we do not assume any respon¬ 
sibility for error in this section. Contact vendor for availability. 


New Products for OS/2 


CThrough++. Developed to support the 
building applications in the C/C++ environ¬ 
ment, Instead of working with files, 
CThrough++ can browse and edit classes and 
their components-data and functions mem¬ 
bers. The product stores all information in 
plain ASCII files and uses an editor to handle 
them* CThrough++ integrates tools to graphi¬ 
cally browse, display, and manage class hier¬ 
archies; edits classes in a logical way; creates 
applications or modules automatically with¬ 
out the need for user-generated files; archives 
classes and manages different versions; and 
compares different classes or various ver¬ 
sions of one class. 

BISS Circle No. 135 

Phone: 44-23-92-89-0, Fax: 44-23-92-89-99 

Fortran 77 10.5. This enhanced version of 
Watcom's Fortran 77 development system 
includes improved productivity with a 
graphical IDE designed for the development 
of both character-mode and GUI application 
on a variety of platforms. This product fea¬ 
tures the advantages of a 32-bit performance, 
an advanced GU! debugger, text editor, and 
profiler. Developers can standardize on a sin¬ 
gle host environment and toolset for multi- 
platform development. 

Watcom Circle No. 136 

Phone; (519) 883-6308 

The Graham Utilities 1.04 for OS/2. Version 
T04 now includes a systems diagnostics 
package for OS/2 systems. This product adds 
six programs and modules to the already 
strong suite of over 50 applications. The new 
utilities add two more HPFS specific pro¬ 
grams, two disaster recovery assistance pro¬ 
grams, a systems diagnostics package, and a 
new disk editor module, which allows HPFS 


disks to be edited in their native format All 
of the base HPFS disk structures are able to 
be edited. The diagnostics program allows 
testing and reporting on individual aspects of 
your computer system including, system 
configuration, parallel and serial port test 
and configuration, video test including text 
and graphics test, floppy disk tests, and hard 
disk and keyboard tests. 

WarpSpeed Computers Circle No. 137 

Phone: 61-3-9384-1060, Fax: 61-3-9386-9979 

KopyKat. KopyKat is a remote-control solu¬ 
tion for OS/2. It provides graphical remote 
control between OS/2 13, 2,X, or Warp PCs 
on LANs with NetBIOS. This product sup¬ 
ports hardware handshaking so developers 
can use high-speed modems at their full 
capacity. In addition, it can display every¬ 
thing that is displayed on an OS/2 desktop 
including full-screen DOS and full-screen 
Win/OS/2 sessions. There are no "don't 
touch" keys. 

Hilgraeve Circle No. 138 

Phone: (800) 826-2760, Fax: (313) 243-0645 

IFF Builder. This authoring system allows 
users to create OS/2 INF or HLP files. These 
files are created by writing "source code" 
files that are then compiled by IBM's IPFC 
compiler into either OS/2 viewable INF files 
or online HLP files. These source code files 
are called IFF files. 

Custom Design Software Circle No. 139 

Phone: (604) 334-2263, Fax: (604) 334-3125 

INDSfile for C1CS. This product includes an 
audit trail for improved security and data 
compression for better performance. It runs 
above the 16-MB line, transfers MVS data sets 
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directly to the workstation, and supports cus¬ 
tomer-written IND$file exits. 

Applied Software Inc. Circle No. 140 

Phone: (215) 348-3500, Fax: (215) 348-3535 

Interactive System Productivity Facility 4.2 
(ISPF). ISPF is a family of licensed pro¬ 
grams for the Multiple Virtual Systems 
(MVS) environment and includes the ability 
to automatically give existing host applica¬ 
tions a GUI without changing, compiling, or 
distributing any application code or host 
screens. Version 4.2 offers client/server 
technology by providing users and pro¬ 
grammers with more functions and flexibil¬ 
ity for creating high-productivity user inter¬ 
faces for their applications. In addition, 
ISPF provides developers with more plat¬ 
forms and communication products from 
which to access applications. GUI elements, 
such as group boxes, radio buttons, and 
drop-down list boxes are included. 

IBM Circle No. 141 

Phone: (800) 426-2279 

Juglar 1.3. This OS/2 test management and 
defect-tracking tool provides workflow capa¬ 
bilities coupled with reporting facilities to 
ensure effectiveness for QA managers. Jugalr 
13 lets developers produce a structured test 
plan and produce accurate management 
information on defect status and activity. In 
addition, this product reduces the time spent 
on testing and bug fixing. 

Systems FX Circle No. 142 

Phone: 44-1844-275175, Fax: 44-1844-343615 

LeadTools DLL for OS/2. Offering an imag¬ 
ing solution for compression, file format sup¬ 
port, conversion, and image processing, 
LeadTools DLL for OS/2 contains color, 
grayscale, and bitonal technology. CMP, 
Lead's bitmap format, features enhanced 
image-processing features, smaller file size, 
and faster decompression. This dynamic link 
library supports OS/2 2.1 and OS/2 Warp 
and can be used to enhance applications 
such as image databases, printing and draw¬ 
ing programs, video production systems, 
FAX systems, and systems for transmitting 
high-quality images using phone lines and 
networks. LeadTools lets the user convert to 
and from a variety of image file formats 


including OS/2's native BMP formats, copy 
and paste with the clipboard, and print. 

Lead Technologies Inc. Circle No. 143 

Phone: (704) 332-5532, Fax: (704) 372-8161 

OS/2 Warp Developer's Package for 
Pentium. This package includes NDP 
Fortran, NDP Fortran 90, NDP Pascal, and 
NDP C/++. In addition, this product works 
with the IBM Workframe. NDP Fortran is a 
full Fortran 77 with BSD 4.2 and DOD exten¬ 
sions. It is 99% VAX/VMS compatible. NDP 
C/C++ is a full AT&T 2.1 compliant compiler 
that provides optimizations for numeric¬ 
intensive application, and NDP Pascal is an 
ANSI/IEEE compliant Pascal that also passes 
BSI Level 0 and can access most of the NDP C 
run-time functions. 

MicroWay Circle No. 144 

Phone: (508)746-7341, Fax: (508) 746-4678 

ObjectCatalog. A distributed, cross-platform 
component reuse facility, ObjectCatalog 
enables different development teams to share 
information about software, design patterns, 
frameworks, documents, and other corporate 
assets. ObjectCatalog allows the user to fill 
out questionnaires and define search patterns 
for finding target entries in local and remote 
catalogs. Matching entries are then presented 
graphically according to their degree of simi¬ 
larity to the request. 

ObjectSpace Inc. Circle No. 145 

Phone: (214) 934-2496, Fax: (214) 663-3959 

ObjectPM Control Pack Library for OS/2. 
This package offers over a dozen control 
types that extend the set of controls supplied 
by OS/2 Presentation Manager. It also sup¬ 
ports the PMCX control window specifica¬ 
tion, allowing these controls to be used with 
products such as the IBM Universal Resource 
Editor and Prominare Designer. The PMCX 
specification is the latest control extension, 
similar in concept to the VBX specification in 
Windows. Included in this package are a 
spreadsheet, cellbox, data field, RTF viewer, 
calendars, and splitbars. All controls in 
ObjectPM Control Pack conform to the 
PMCX architecture, allowing the components 
to be used by any OS/2 programming tool. 
Secant Technologies Inc. Circle No. 146 
Phone: (216) 595-3830, Fax: (216) 292-2546 
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Paradigm Plus 3.0. This object-ori¬ 
ented development tool supports the 
entire software development lifecycle- 
Its graphical environment automates 
leading object-oriented methodologies 
and notations, including QMT, Booch, 
Fusion, Martin/Odell, Caod/Yourdon, 
and Shlaer/Mellor, while also allow¬ 
ing the developer to customize meth¬ 
ods based on business requirements. 
Paradigm Plus generates code in C, 
C++, Ada, and Smalltalk, as well as 
RDBMS and ODBMS schema defini¬ 
tions. Utilizing an advanced object 
repository and open architecture, the 
product optimizes reuse by allowing 
access to all stored objects and rela¬ 
tionships in a multiuser environment. 
Unlike other object-oriented tools cur¬ 
rently available on the market. 
Paradigm Plus facilitates reverse engi¬ 
neering of existing development 
efforts. 


ProtoSoft Inc. Circle No. 147 

Phone: (713) 480-3233, Fax: (713) 480- 
6606 


Partition Magic. This product will let 
developers visually modify a hard 
disk on screen as well as shrink, 
expand, move, and convert partitions 
without destroying data. Partition- 
Magic automatically converts a FAT 
file system to HPFS, creates room for 
Boot Manager either before or after 
OS/2 is installed, and combines 
unused portions of several partitions 
into a larger block, 

PowerQuest Corp. Circle No, 148 
Phone: (800) 379-2566, Fax: (801) 226- 
8941 


RhinoCom 1.5. RhtnoCom's Work¬ 
place Shell interface replaces the dial¬ 
ing directory with an intuitively 
object-oriented phone book, or 
Rhinodex. This product includes 
extensive configurability with logical 
defaults, full-featured macros, fast 
transfers, and RE XX scripting. 
Enhanced features include, automated 
script learning with AutoLogon, 
graphical manipulations of global set¬ 
tings, host mode as a secure back¬ 
ground BBS, and the CompuServe B+ 
transfer protocol, 


Rhintek Inc. Circle No. 149 

Phone: (410) 730-2575, Fax: (410) 730- 
5960 

Velocis 1.3.1, This product offers soft¬ 
ware developers access to tools for cre¬ 
ating high-performance client/server 
applications. New features include 
transaction-processing performance 
improvements, robust dynamic control 
over low-disk space conditions, im¬ 
proved server configuration capabili¬ 
ties, and additional administration API 
functions. Use of the server extensions 
allows three-tier architecture, which 
can reduce network traffic and take 
advantage of server power by parti¬ 
tioning application logic between client 
and server. This product also supports 
server extensions created in C++. 

Raima Corp. Circle No. 150 

Phone: {206} 557-0200, Fax: (206) 557- 
5200 

Show N Tel 3,0. This object-oriented 
development environment for building 
and implementing telephony systems 
enables interactive voice, fax, call pro¬ 
cessing, speech recognition, call center, 
and multimedia messaging applica¬ 
tions. This release adds a range of new 
functions for corporate developers, sys¬ 
tem integrators, and OEMs, including 
over 100 PowerBlocks-graphical pro¬ 
gram design objects representing high- 
level application functions. Show N Tel 
includes a palette of over 300 
PowerBlocks, with new objects for 
tighter PBX and switch control, in-chas- 
sis switching, and text-to-speech, mes¬ 
saging, and interactive fax functions. 

Technically Speaking Circle No, 151 
Phone: (508) 229-7777, Fax: (508) 229- 
8777 

Spoolview, Spoolview, a product 
released by Datatrade, now supports 
OS/2 client and server platforms. It is 
a multiplatform application that col¬ 
lects reports from all IBM host sys¬ 
tems via file transfer or tape input. 
The reports are then automatically 
indexed, compressed, and transferred 
to IBM 3995 optical media. Users have 
the ability to view, print, fax, and 
export data via LAN-based PCs run¬ 


ning OS/2. Native IBM AFP advanced 
print streams are fully supported. 

Datatrade Circle No. 152 

Phone: (417) 882-1576, Fax: (417) 882- 
8423 

Snow Report Writer. Part of Snow's 
cross-platform family of client/server 
report-writing solutions, this product 
uses the common word processor 
metaphor to design, format, and place 
data in reports. The product incorpo¬ 
rates second-generation report-writing 
features. The Snow engine provides 
report-writing capabilities without 
requiring the knowledge of an underly¬ 
ing data access language, such as SQL. 

Snow Software Circle No. 153 

Phone: (813) 784-8899, Fax: (813) 787- 
1904 

AHA-2940 Ultra Wide. The AHA- 
2940 Ultra Wide single-channel PCT 
to-SCSI host adapter offers faster I/O 
throughput and improved efficiency 
for PCI-based systems by speeding 
data exchange between SCSI periph¬ 
erals and the PCI system at speeds of 
up to 40 MB/second. In addition, the 
adapter's flexible design allows cus¬ 
tomers to utilize existing SCSI periph¬ 
erals, connections, and cabling, pro¬ 
tecting their existing investment. This 
product can also support the mixing 
of 8- and 16-bit devices on the same 
SCSI cable, without affecting the reli¬ 
able operation of the system, 

Adaptec Circle No. 154 

Phone: (408) 262 8600, Fax: (408) 262- 
2533 

UniMaint 4.0. UniMaint for OS/2 
uninstalls any OS/2 application, in¬ 
cluding freeware, shareware, or com¬ 
mercial software. In addition, Uni¬ 
Maint maintains OS/2 INI files and 
extended attributes while also per¬ 
forming desktop backups or portable 
desktop backups to port an OS/2 
desktop to your laptop computer or 
your machine at home. 

SofTouch Systems Inc. Circle No. 155 
Phone: (405) 947-8080, Fax: (405) 632- 
6537 
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Bring enterprise-wide alphanumeric 
paging to your network and monitor 
mission critical applications across the 
enterprise with Sky Agent™. Save time, 
money and trim your 1/S paging support 
costs by consolidating your enterprise's 
outbound paging operations into a single 
paging center. SkyAgent can be used to 
monitor system processes for 
predetermined events - which in turn can 
automatic ally page the appropriate 
network support staff. 

Through leading edge TCP/IP SNMP 
technology and Sky Agent's SNMP 
extensible "paging" agent, every SNMP- 
ready host on your LAN or WAN has the 
capability to send multiple text messages 
to multiple pager devices in multiple 
locations with a single host SNMP 
command. 

Get important messages from all your 
computer systems to the right people in 
your organization at the right time, 24 
hours a day, 7 days a week, whether 
they're in New York, Los Angeles, or on 
an airplane somewhere in between. With 
SkyAgent, you avoid having to install 
paging software on every computer 
system in your enterprise. Plus, you get 
the ultimate, full-function paging server 
for all hosts on your network. 

You can ensure your mission critical 
apps are well taken care of - when you 
connect your best LAN support people 
with SkyAgent. 


Copyright GammaTech Inc. 1995 


9 Industry standard SNMP agent interface means sending requests to a SkyAgent server is as easy a: 
issuing a single command from a host out across your network 

0 Connectability to an unlimited number of "pager company" service providers through multiple, 
simultaneous, T.A.P. modem connections means you can reach anyone in any provider's service 
areas 


f High volume message queuing and delivery rates can handle 500,000+ messages per month from 
hundreds of different systems 

9 Built-in user data base allows messages to be sent to nicknames and groups so that no one has to 
remember pager numbers - This data base may be updated remotely via SNMP requests to lessen 
system administration costs 

® SkyAgent standardizes your enterprise’s computer-based paging and lowers paging support costs 
for your organization 

® Complete logging, tracing, and diagnostic options ensure system and message accountability 

# SkyAgent is designed around IBM’s OS/2 Warp operating system and is a full 32-bit, multitasking 
server process 

® SkyAgent is designed to run in an unattended environment and may be monitored remotely from 
any type of SNMP "network management station" 

MIB definition files are included for most common host platforms 


® Optionally purchase all hardware, configured "ready for use", and simply plug it into your networl 
for immediate computer-based paging service 




(800) 944-3028 StM FAX (405) 632-653 


SofTouch Systems, Inc. 

1300 S. Meridian, Suite 600, Oklahoma City, OK 73108-1751 
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You get the mouse. Head up the screen. 



Pull in a database server. FIVE seconds to lunch. 



You distribute a transaction. FOUR. Put a move 



on multimedia. THREE. Drag. TWO. Drop. ONE... 



^feeesssss. It’s all over, baby. 


It’s easy to see why nothing propels you into the big 
leagues of object-oriented programming like our new 
VisualAge™ C++ version 3.0. 

It transcends mere GUI builders. 

This fully integrated development 
environment lets you generate tight, last client/server 
applications w ith point-and-click ease and efficiency. 

A simple drag-and-drop incorporates the 
truly scalable capabilities of a vast library of 
pre-buiit Open Class objects, which means 
you can create distributed client/server apps 


quickly .And with Open Class and C++ compilers for 
OS/2: Sun™ Solaris; QS/400* AIX: and MVS, deploying 
your new object-oriented apps across 
multiple platforms is really easy We 
thought that new features like these 
would excite you. InfowoM agreed, and has called our 
new VisualAge C++ “object reusability at its finest” and 
“a masterpiece of visual programming’’* 
True 00 client/server development w ith 
VisualAge C++ for OS/2. It could be the 
best move you make. 


Can your software do this? 



Get a Developer's Kit ieduding OS/2 Warp and a CD featuring an evaluation 
copy of DB2* v2 when you buy VisualAge C++ for OS/2. 4 Call your authorized 
IBM reseller or 1 800 3IBM-QS2, Dept. SA019. 

is a hmiteO-trTw o#tef. recavE your Oeweioper'5. KJi. swnpiy and raurn VfeuatAjpe C+ + card tiy Ctecsmbef 29. tags OS/? Warp will be shipped on CD AQm fluty In Cana*, pfeastaii f800 ffiM-CAU. erf &R? Outside Noun America. contact your local 

®M Otoe* VBuaiAjje C++ tor 05/400 be available fi A9\ (Xl 1995. The IBM software borne pape s totaled an hi® Jfmm saftware.ibm.com IBM. 0$/?. DflZ OS/400 and AJK are registered trademarks and vtsuaiAge to a trademark, pf imemationji Business Machines Corporation Ai otto 
trademariariBie property dffiw rispectirt owners. ’WMQiMrev^ 5/B/9S. & 1995 IBM Corporation All ngftfe reserved. 
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Solutions for a small planet? 










